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 herramienta 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. Selecciona el proyecto de Cloud que deseas usar para acceder al servicio.
  3. En la página Biblioteca de API, haz clic en Habilitar.

Configura la autorización

Sigue estos pasos para autorizar la API de Service Usage a fin de acceder al proyecto de Cloud:

  1. Crea una cuenta de servicio.
    1. Ve a la página Cuentas de servicio de Cloud Console.
      Ir a la página Cuentas de servicio
    2. Selecciona el proyecto de Cloud que deseas 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.
  2. Otorga a tu cuenta de servicio nueva la función de administrador de Service Usage. Para obtener información sobre cómo otorgar funciones a la cuenta de servicio, consulta Cómo otorgar funciones a las cuentas de servicio.
  3. Configura tu máquina local.

    1. Ve a la página Credenciales de API de Cloud Console.
      Ir a la página Credenciales de API
    2. 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 obtener información sobre cómo crear claves de cuenta de servicio, consulta Cómo crear y administrar claves de cuenta de servicio.
    3. Instala oauth2l en tu máquina local para que puedas interactuar con el sistema Google OAuth.
    4. De manera opcional, usa oauth2l para crear un token del portador mediante tu archivo de credenciales; Esto verifica que tu configuración de OAuth sea correcta y que el archivo de credenciales de tu cuenta de servicio sea válido:

          oauth2l header --json ~/credentials.json cloud-platform userinfo.email
      

      Cuando se ejecuta de forma correcta, el resultado es similar al siguiente:

          Authorization: Bearer y29.xxxxxxx
      

Realiza pruebas con curl

  1. 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"'
    
  2. Configura una variable de entorno PROJECT_ID con el identificador de tu proyecto:

    PROJECT_ID="my-project-id"
    
  3. Asegúrate de haber accedido a “gcloud”:

    gcloud auth login
    
  4. Usa gcloud para encontrar el número de proyecto y guárdalo en una variable de entorno:

    PROJECT_NUMBER=`gcloud projects list --filter="${PROJECT_ID}" --format="value(PROJECT_NUMBER)"`
    
  5. Enumera las API y los servicios habilitados en este proyecto:

    gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED&fields=services.config.title,services.config.name"
    

    Si ves un resultado como este, tu configuración se realizó correctamente:

    {
    "services": [
      {
        "config": {
          "name": "bigquery.googleapis.com",
          "title": "BigQuery API"
        }
      },
      {
        "config": {
          "name": "bigquerystorage.googleapis.com",
          "title": "BigQuery Storage API"
        }
      },
      ...
    

Próximos pasos

Sigue los Muestra una lista de servicios a fin de enumerar los servicios y las API que están habilitados o disponibles en tus proyectos de Cloud.