Cómo empezar

En esta página, se explica cómo los desarrolladores pueden comenzar a usar las Cloud de Confiance by S3NS APIs.

Si es la primera vez que usas las APIs de Cloud de Confiance , puedes seguir los pasos de esta guía para llamar a las APIs con comandos de curl. Puedes usar comandos curl para experimentar con una API antes de desarrollar tu aplicación.

Cómo crear un proyecto de S3NS

Para usar las APIs de Cloud de Confiance , debes tener una cuenta de usuario (una cuenta deS3NS o una cuenta de unproveedor de identidad externo) y un proyecto deS3NS . Un proyecto equivale a una cuenta de desarrollador. Sirve como contenedor de recursos para tus recursos de Cloud de Confiance . También proporciona un límite de aislamiento para el uso de los servicios de Cloud de Confiance by S3NS , de modo que puedes administrar los límites de cuota y la facturación de forma independiente a nivel del proyecto. La telemetría y los paneles de uso también se agrupan por proyectos. Si aún no tienes un proyecto, puedes crear uno con la consola deCloud de Confiance .

Un proyecto puede ser propietario de una amplia variedad de recursos, incluidas claves de API, clientes de OAuth, cuentas de servicio, VMs de Compute Engine, buckets de Cloud Storage y conjuntos de datos de BigQuery. Cuando una aplicación llama a una API de Cloud de Confiance , el proyecto que posee las credenciales de la aplicación se denomina proyecto cliente, y el proyecto que posee el recurso de destino se denomina proyecto de recursos. Si una solicitud de API afecta a varios recursos, se involucran varios proyectos de recursos.

Si quieres dejar de usar Cloud de Confiance por algún motivo, puedes usar la consola deCloud de Confiance para borrar tu proyecto. Tu proyecto y todos los recursos que contenga se borrarán después del período de retención. Ten en cuenta que los diferentes tipos de datos tienen diferentes períodos de retención.

Descubre APIs

Antes de usar cualquier Cloud de Confiance API, debes usar la Cloud de Confiance consola de laBiblioteca de APIs para explorar lasCloud de Confiance APIs disponibles y descubrir las que mejor se adapten a las necesidades de tu empresa.

Se están habilitando las API

Algunas APIs de Cloud de Confiance están habilitadas de forma predeterminada. Para usar una API de Cloud de Confianceque no está habilitada de forma predeterminada, debes habilitarla en tu proyecto. Según los servicios y los proyectos involucrados en tu aplicación, incluidos el proyecto del cliente y los proyectos de recursos, es posible que debas habilitar una API para varios proyectos. Cuando habilitas una API que depende de otras APIs, estas también se habilitan al mismo tiempo.

Para habilitar una API, debes aceptar las Condiciones del Servicio y la responsabilidad de facturación de la API. Necesitas permiso serviceusage.services.enable en el proyecto para habilitar las APIs. Para obtener más información, consulta Control de acceso de Service Usage.

Para habilitar una API para un proyecto con la consola:

  1. Ve a la Cloud de Confiance Biblioteca de APIs de la consola.
  2. En la lista de proyectos, selecciona el que deseas usar.
  3. En la biblioteca de API, selecciona la API que quieres habilitar. Si necesitas ayuda para encontrar la API, usa el campo de búsqueda y los filtros.
  4. En la página de API, haz clic en HABILITAR.

En la misma página, puedes inhabilitar una API para tu proyecto si ya no la usas y, así, evitar el uso inadecuado y los cargos accidentales de facturación. También puedes habilitar e inhabilitar las API de Cloud con gcloud CLI y la API de Service Usage:

gcloud services enable pubsub.googleapis.com
gcloud services disable pubsub.googleapis.com

Habilitar la facturación

Algunas APIs de Cloud cobran por el uso. Debes habilitar la facturación para tu proyecto antes de comenzar a usar estas APIs en él. El uso de la API en un proyecto se cobra a la cuenta de facturación asociada al proyecto.

Autenticación en las APIs

La forma en que te autenticas en una API depende de tu entorno de desarrollo y de los métodos de autenticación que admite la API.

Configurar las credenciales predeterminadas de la aplicación para usarlas en diversos entornos es el enfoque más común y se recomienda para la mayoría de las aplicaciones. Si la API admite claves de API, esa es otra opción. Si tu aplicación necesita acceder a los recursos de Cloud que pertenecen a tus usuarios finales, debes crear un ID de cliente de OAuth 2.0 y usar las bibliotecas de autenticación.

Para obtener información general sobre la autenticación, consulta Autenticación en Google.

Compila aplicaciones

Si compilas una aplicación con las API de Cloud, te recomendamos que uses las Cloud de Confiance bibliotecas cliente si están disponibles. Las bibliotecas cliente pueden controlar funciones comunes de la API para tu comodidad, como la autenticación, el manejo de errores, el reintento y la validación de la carga útil. Debes pasar las credenciales de tu aplicación a las bibliotecas cliente durante la inicialización para que estas puedan realizar llamadas a las APIs deCloud de Confiance en nombre de tu aplicación.

Más información