Cómo comenzar

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

Si usas las API de Google Cloud por primera vez, puedes seguir los pasos de esta guía para llamar a las API 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 productos para desarrolladores de Google, incluidos Google Cloud Console, la CLI de gcloud, Cloud Logging y Cloud Monitoring. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen USD 300 en créditos gratuitos para ejecutar, probar e implementar cargas de trabajo.

Crea un proyecto de Google

Para usar las API de Cloud, también necesitas tener un proyecto de Google. Un proyecto es equivalente a una cuenta de desarrollador. Sirve como contenedor de recursos para los recursos de Google Cloud. También proporciona un límite de aislamiento para tu 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 de proyecto. La telemetría de uso y los paneles también se agrupan por proyecto. Si aún no tienes un proyecto, puedes crear uno con Google Cloud Console.

Un proyecto puede tener una gran variedad de recursos, como claves de API, clientes de OAuth, cuentas de servicio, VM de Compute Engine, depósitos de Cloud Storage y conjuntos de datos de BigQuery. 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 a la API puede tocar varios recursos, por lo que involucra varios proyectos de recursos.

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

Descubre API

Antes de usar cualquier API de Cloud, debes usar la Biblioteca de API de Google Cloud Console para explorar las API de Cloud disponibles y descubrir las que mejor se adapten a tus necesidades empresariales. Para obtener más información sobre una API de Cloud específica, visita su sitio de documentación público, como la API de Spanner.

Habilitando las APIs

Algunas API de Cloud están habilitadas de forma predeterminada. Para usar una API de Cloud que no está habilitada de forma predeterminada, debes habilitarla en tu proyecto. Según los servicios y los proyectos que estén 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 API, esas API 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 el permiso serviceusage.services.enable en el proyecto para habilitar las API. Para obtener más información, consulta Control de acceso de Service Usage.

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

Para habilitar una API para un proyecto con la consola:

  1. Ve a la Biblioteca de API de Google Cloud Console.
  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.

Desde la misma página, puedes inhabilitar una API para tu proyecto si ya no la usas para evitar usos inadecuados y cargos de facturación accidentales. También puedes habilitar o inhabilitar las API de Cloud mediante gcloud CLI y la API de Service Usage:

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

Habilitando la facturación

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

Si no tienes una cuenta de facturación, ve a la página de facturación de Google Cloud Console y sigue las instrucciones para crear una. Luego, vincula tu cuenta de facturación a tu proyecto.

Autentica en las API

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

La configuración de credenciales predeterminadas de la aplicación para su uso 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 las claves de API, esa es otra opción. Si tu aplicación necesita acceder a los recursos de Cloud que son propiedad de tus usuarios finales, 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 que uses las bibliotecas cliente de Google Cloud si están disponibles. Las bibliotecas cliente pueden manejar características comunes de la API para tu comodidad, como autenticación, manejo de errores, reintento y validación de carga útil. Debes pasar tus credenciales de aplicación a las bibliotecas cliente durante la inicialización para que estas puedan realizar llamadas a las API de Google Cloud en nombre de tu aplicación.

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

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

Más información