Primeros pasos

En esta página se describe cómo configurar tu entorno de desarrollo para usar la API de Service Usage.

  • Para la mayoría de los casos prácticos operativos, la forma más sencilla de habilitar e inhabilitar los servicios es usar Google Cloud Console.
  • Si quieres crear secuencias de comandos, puedes usar la interfaz de línea de comandos de gcloud.
  • Si quieres programar soluciones basadas en la API de Service Usage, usa una de las bibliotecas cliente.
  • Para experimentar con la API, puedes seguir las instrucciones alternativas de configuración que aparecen en esta guía y usar el comando curl para probar la API sin configurar un entorno completo de desarrollo de aplicaciones.

Configura el entorno para realizar llamadas directas a la API

En esta sección se describen los pasos básicos necesarios para configurar su entorno local a fin de experimentar con la API de Service Usage mediante el comando curl. Está dirigida a desarrolladores que necesiten programar en la API de Service Usage.

Habilita la API de Service Usage

Para usar la API de Service Usage, debes habilitarla en el proyecto de Cloud en el que quieras utilizarla.

  1. Ve a la página Biblioteca de API de Google Cloud Console.
    Ir a la página Biblioteca de API
  2. Haz clic en Seleccionar para elegir el proyecto de Cloud que quieres usar para acceder al servicio.
  3. En la página Biblioteca de API, haz clic en Habilitar.

Crea una cuenta de servicio

Crea una cuenta de servicio y una clave para ejecutar los comandos de curl que aparecen en esta sección:

  1. Ve a la página Cuentas de servicio de Cloud Console.
    Ir a la página Cuentas de servicio
  2. Haz clic en Seleccionar para elegir el proyecto de Cloud que quieres usar para acceder al servicio.
  3. Crea una cuenta de servicio. Para obtener información sobre cómo crear cuentas de servicio, consulta Crea y administra cuentas de servicio. Para seguir las instrucciones de esta sección, debes otorgarle la función roles/serviceusage.serviceUsageAdmin a la cuenta de servicio. Para aprender a otorgar funciones a las cuentas de servicio, consulta Asigna funciones a cuentas de servicio.
  4. Ve a la página Credenciales de API de Cloud Console.
    Ir a la página Credenciales de API
  5. Crea una clave de cuenta de servicio para la cuenta de servicio nueva y descarga el archivo de credenciales JSON en tu máquina local. En los ejemplos de esta guía, se supone que la ruta del archivo es ~/credentials.json. Para aprender a crear claves de cuentas de servicio, consulta Crea y administra claves de cuentas de servicio.
  6. Instala oauth2l en tu máquina local para que puedas interactuar con el sistema Google OAuth.

Realiza pruebas con curl

  1. Verifica primero la configuración inicial:

    oauth2l header --json ~/credentials.json cloud-platform
    
  2. Después de terminar el flujo de OAuth, deberías ver un resultado similar al que figura a continuación:

    Authorization: Bearer y29.xxxxxxx
    
  3. Define un alias de shell conveniente para llamar a las API de REST de Google:

    alias gcurl='curl -H "$(oauth2l header --json ~/credentials.json cloud-platform userinfo.email)" -H "Content-Type: application/json"'
    
  4. Muestra las API y los servicios habilitados en un proyecto:

    gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services
    

    Si ves una lista de servicios, la configuración se realizó correctamente.

Próximos pasos

Sigue las instrucciones del artículo Cómo mostrar una lista de servicios para enumerar las API y los servicios que están habilitados o disponibles en {project_name_short}}s.