Cómo empezar

Configurar un proyecto de Google Cloud y la autenticación te permite llamar a las APIs de Google Cloud desde tus aplicaciones. En este documento, comenzarás a usar las APIs de Google Cloud creando un proyecto, descubriendo y habilitando servicios en la Biblioteca de APIs, vinculando una cuenta de facturación, configurando credenciales y explorando bibliotecas cliente.

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 Cloud

Para usar las APIs de Google Cloud , debes tener una cuenta de usuario (una cuenta deGoogle o una cuenta de un proveedor de identidad externo) y un proyecto deGoogle Cloud . Un proyecto equivale a una cuenta de desarrollador. Funciona como un contenedor de recursos para 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 también se agrupan por proyectos. Si aún no tienes un proyecto, puedes crear uno con la consola deGoogle 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 conjuntos de datos de BigQuery. Cuando una aplicación llama a una API de Google Cloud , el proyecto que posee las credenciales de la aplicación se denomina proyecto de cliente, y el proyecto que posee el recurso objetivo se denomina proyecto de recurso. Algunas solicitudes a la API pueden afectar a varios recursos, en cuyo caso puede haber más de un proyecto de recursos involucrado en la solicitud.

Si quieres dejar de usar Google Cloud por cualquier motivo, puedes usar la consola deGoogle Cloud para borrar tu proyecto. Tu proyecto y todos los recursos que contiene se borrarán después de la ventana de retención. Ten en cuenta que los diferentes tipos de datos tienen distintos períodos de retención.

Descubre APIs

Antes de usar cualquier API de Google Cloud , debes usar laBiblioteca de APIs de la consola de Google Cloud para explorar las APIs deGoogle Cloud disponibles y descubrir las que mejor se adapten a tus necesidades empresariales.

Habilitando las APIs

Algunas APIs de Google Cloud están habilitadas de forma predeterminada. Para usar una API de Google Cloud que no esté habilitada de forma predeterminada, debes habilitarla en tu proyecto. Según los servicios y los proyectos que participen en tu aplicación, incluidos el proyecto de 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 el permiso serviceusage.services.enable en el proyecto para habilitar las APIs.

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

Para habilitar una API para un proyecto con la consola:

  1. Ve a la biblioteca de la API de la consola deGoogle 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 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, con el objetivo de evitar el uso inadecuado y los cargos de facturación accidentales. También puedes habilitar e inhabilitar las API de Cloud con 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 en tu proyecto para poder comenzar a usar estas APIs. El uso de la API en un proyecto se cobra a la cuenta de facturación asociada al proyecto.

Si no tienes una cuenta de facturación, ve a la página de facturación de la consola deGoogle Cloud y sigue las instrucciones para crear una. Luego, vincula tu cuenta de facturación 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 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 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 bibliotecas cliente deGoogle Cloud 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 deGoogle 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 APIs populares:

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

Más información