Primeros pasos

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

Si usas APIs de Google Cloud por primera vez, puedes seguir estos pasos: los pasos de esta guía para llamar a las APIs con los comandos de curl. Puedes usar Comandos curl para experimentar con una API antes de desarrollar tu aplicación.

Creación de una cuenta de Google

Para usar las API de Google Cloud en tus aplicaciones, primero debes tener una Cuenta de Google. Esto te permite usar los productos para desarrolladores de Google, como Consola de Google Cloud, gcloud CLI, Cloud Logging y Cloud Monitoring. Si eres nuevo en Google Cloud, crear una cuenta para evaluar el rendimiento de nuestros productos en escenarios del mundo real. Los clientes nuevos también obtienen USD 300 en créditos gratuitos para ejecutar, probar e implementar cargas de trabajo.

Cómo crear un proyecto de Google

Para usar las API de Cloud, también debes tener un proyecto de Google. Un proyecto es equivalente a una cuenta de desarrollador. Funciona como contenedor de recursos tus recursos de Google Cloud. También proporciona un límite de aislamiento para el uso de los servicios de Google Cloud, de modo que puedas administrar los límites de cuota y la facturación de forma independiente a nivel del proyecto. La telemetría de uso y los paneles se agrupan por proyectos. Si aún no tienes un proyecto, puedes crear uno. con la consola de Google Cloud.

Un proyecto puede tener una amplia variedad de recursos, como claves de API, clientes de OAuth, cuentas de servicio, VMs de Compute Engine, buckets de Cloud Storage y BigQuery conjuntos de datos. Cuando una aplicación llama a una API de Cloud, 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. Una solicitud de API puede tocar múltiples recursos, por lo que se involucran múltiples proyectos de recursos.

Si quieres dejar de usar Google Cloud por alguna razón, puedes usar Consola de Google Cloud para borrar tu proyecto. Tu proyecto y todos los recursos en él se borrarán después de la retención en la ventana modal. Ten en cuenta que los diferentes tipos de datos tienen diferentes períodos de retención.

Cómo descubrir APIs

Antes de usar cualquier API de Cloud, debes usar la Biblioteca de APIs de la consola de Google Cloud para explorar las APIs de Cloud disponibles y descubrir las que mejor se adapten a las necesidades de tu empresa. Para obtener más información sobre una API de Cloud específica, visita sus sitio de documentación, como la API de Spanner.

Se están habilitando las API

Algunas APIs de Cloud están habilitadas de forma predeterminada. Para usar una API de Cloud que no está habilitada de forma predeterminada, debes habilitarla para tu proyecto. Según los servicios y los proyectos involucrados en tu aplicación, incluidos el proyecto 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 están habilitadas al mismo tiempo.

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

Además, el servicio que se habilitará debe ser público, o bien el propietario del servicio debe otorgarle al usuario el permiso servicemanagement.services.bind en el servicio privado. Consulta Control de acceso de Service Management para obtener más información información.

Para habilitar una API para un proyecto con la consola:

  1. Ve a la sección Biblioteca de APIs de la consola de Google Cloud.
  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 o 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 para evitar el uso inadecuado y los cargos de facturación accidentales. También puedes habilitar e inhabilitar las API de Cloud usando la 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 tu proyecto. El uso de la API en un el proyecto se cobra a la cuenta de facturación asociada con el proyecto.

Si no tienes una cuenta de facturación, ve a Página de facturación de la consola de Google Cloud y sigue las instrucciones para crear una. Después vincular tu cuenta de facturación a tu proyecto.

Autenticación en las APIs

La forma de autenticarte en una API depende de tu entorno de desarrollo y de qué métodos de autenticación compatibles con la API.

Configurar las credenciales predeterminadas de la aplicación para usarlas en una variedad de 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 recursos de Cloud que son propiedad de tus usuarios finales, puedes Crea un ID de cliente de OAuth 2.0 y usa 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 Bibliotecas cliente de Google Cloud si disponibles. Las bibliotecas cliente pueden controlar funciones de API comunes para tu conveniente, como la autenticación, el manejo de errores, los reintentos y la carga útil. validación. Debes pasar las credenciales de tu aplicación al cliente. bibliotecas durante la inicialización, para que las bibliotecas cliente puedan hacer llamadas las APIs de Google Cloud en nombre de tu aplicación.

Consulta las siguientes guías paso a paso que usan las bibliotecas cliente para algunas APIs populares:

Para obtener más información, consulte Explicación de las bibliotecas cliente.

Más información