Comenzar

Esta página explica cómo los desarrolladores pueden comenzar a usar las API de Cloud.

Creación de una cuenta de Google

Para usar las API de Cloud en tus aplicaciones, primero debes tener una cuenta de Google. Esto te permite usar productos para desarrolladores de Google, como Cloud Console y Stackdriver Logging y Monitoring. Si no tienes una cuenta de Google, puedes registrarte para obtener una en esta página.

Crea 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 un contenedor de recursos para tus recursos de Google Cloud Platform (GCP). También proporciona un límite de aislamiento para tu uso de los servicios de GCP, por lo que puedes 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 Cloud Console.

Un proyecto puede tener una amplia gama de recursos, incluidas 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 aplicación se llama al proyecto de cliente, y el proyecto que posee el recurso de destino se llama recurso del proyecto. Una solicitud de API puede tocar varios recursos, por lo tanto, hay varios proyectos de recursos involucrados.

Si quieres dejar de usar GCP por algún motivo, puedes usar 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.

Se están habilitando las API

Para usar una API de Cloud, debes habilitarla en tu proyecto. Según la cantidad de proyectos involucrados, 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 permiso serviceusage.services.enable en el proyecto y permiso servicemanagement.services.bind en la API para habilitarlo. 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 Cloud Console.
  2. En la lista de proyectos, selecciona un proyecto o crea uno nuevo.
  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 el uso inadecuado y los cargos de facturación accidentales. También puedes habilitar e inhabilitar las API de Cloud con el SDK de Cloud y la API de Service Usage.

Habilita la facturación

Algunas API de Cloud cobran por el uso. Debes habilitar la facturación para tu proyecto antes de que puedas 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 Cloud Console y sigue las instrucciones para crear una. Luego, vincula tu cuenta de facturación a tu proyecto.

Cómo crear aplicaciones

Si estás compilando una aplicación con las API de Cloud, te recomendamos usar las bibliotecas cliente de Google Cloud, si están disponibles. Las bibliotecas cliente manejan funciones de API comunes para su comodidad, como la autenticación, el manejo de errores, el reintentos y la validación de la carga útil. Para obtener más información, consulta Explicación de las bibliotecas cliente.

Cómo obtener y usar las credenciales de la aplicación

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

Las API de Cloud usan credenciales de aplicación para identificar las aplicaciones que llaman. Los tipos de credenciales incluyen claves de API, clientes de OAuth 2.0 y cuentas de servicio. Para obtener más información sobre la autenticación y las credenciales de la aplicación, consulta Descripción general de la autenticación.

Si eres nuevo en las API de Google y solo quieres ejecutar algunas pruebas manuales antes de escribir código, puedes usar oauth2l para generar las credenciales de la solicitud y usarlas con el comando curl.

Más información

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.

A fin de obtener más información sobre el uso de una API o herramienta de línea de comandos para habilitar o inhabilitar API, consulta Habilita o inhabilita servicios en la documentación de Service Usage.