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, como Google Cloud Console, 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.

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. Sirve como contenedor de recursos para los recursos de Google Cloud. También proporciona un límite de aislamiento para el uso que haces 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 console.

Un proyecto puede ser propietario de una gran variedad de recursos, como claves de API, clientes de OAuth, cuentas de servicio, VM de Compute Engine, buckets 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 llama proyecto del cliente, y el proyecto que posee el recurso de destino se denomina proyecto del recurso. Una solicitud a la API puede tocar varios recursos, por lo que participan varios proyectos de recursos.

Si deseas dejar de usar Google Cloud por algún motivo, puedes usar Console para borrar tu proyecto. Tu proyecto y todos los recursos del proyecto 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.

Cómo descubrir 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 cuáles se adaptan mejor a las necesidades de tu empresa. 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 API

Para usar una API de Cloud, debes habilitarla en tu proyecto. Según los servicios y los proyectos que participen de tu aplicación, incluidos el proyecto del cliente y los proyectos de recursos, es posible que debas habilitar una API para varios proyectos.

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.

Para habilitar una API para un proyecto con la consola:

  1. Ve a la Biblioteca de API de la consola.
  2. En la lista de proyectos, selecciona el que quieres 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 a fin de evitar el uso inadecuado y los cargos de facturación accidentales. También puedes habilitar o inhabilitar las API de Cloud con la CLI de gcloud y la API de Service Usage:

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

Habilita la facturación

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

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

Obtén las credenciales de la aplicación

Las API de Cloud solo aceptan solicitudes a la API de aplicaciones registradas. Este requisito ayuda a los productores de API a asociar y también informar el uso de la API al proyecto correcto que posee la aplicación.

Las API de Cloud usan credenciales de aplicaciones para identificar las aplicaciones que realizan las llamadas. Los tipos de credenciales incluyen claves de API, clientes de OAuth 2.0 y cuentas de servicio. Puedes usar console para crear, recuperar y administrar las credenciales de tu aplicación. Para obtener más información sobre las credenciales de la aplicación, consulta Descripción general de la autenticación.

Usar credenciales de aplicación

Si eres nuevo en las API de Google Cloud, te recomendamos que uses oauth2l para experimentar con las credenciales de tu aplicación y las API de Cloud antes de escribir cualquier código de aplicación. oauth2l puede aceptar las credenciales de la aplicación y usarlas para realizar llamadas a las API de Google Cloud con el comando de curl.

Ejemplo:

oauth2l curl --credentials ./creds.json --scope cloud-platform --url https://pubsub.googleapis.com/v1/projects/my-project-id/topics -- -v

Compilar 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 controlar características de API comunes para tu conveniencia, como la autenticación, el manejo de errores, los reintentos y la validación de cargas útiles. Debes pasar tus credenciales de la aplicación a las bibliotecas cliente durante la inicialización, de modo que estas puedan realizar llamadas a las API de Google Cloud en nombre de tu aplicación.

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

Más información

Para obtener más información sobre la autenticación, consulta Descripción general de la autenticación.

Para obtener más información sobre el manejo de errores, consulta Cómo solucionar errores.

Para obtener más información sobre la facturación, consulta Crea, modifica o cierra tu cuenta de facturación.

Para obtener más información sobre la habilitación de la facturación en tu proyecto, consulta Modifica la configuración de facturación de un proyecto.

Para obtener más información sobre cómo habilitar o inhabilitar las API, consulta Habilita o inhabilita servicios.