Configurar o Service Usage para um ambiente de desenvolvimento

Esta página descreve como configurar seu ambiente de desenvolvimento para usar a API Service Usage.

  • Na maioria dos casos de uso operacional, a maneira mais simples de ativar e desativar serviços é usar o console do Google Cloud.
  • Se você precisar criar scripts, use a CLI do Google Cloud.
  • Se você precisar programar na API Service Usage, use uma das bibliotecas de cliente.
  • Para testar a API, siga as instruções de configuração alternativas neste guia e use o comando curl para testar a API sem configurar um ambiente de desenvolvimento de aplicativo completo.

Configuração para chamar a API diretamente

Esta seção descreve as etapas básicas necessárias para configurar seu ambiente local para testar a API Service Usage usando o comando curl. Ela tem como foco os desenvolvedores que precisam programar com os recursos da API Service Usage.

Ativar a API Service Usage

Para usar a API Service Usage, você precisa primeiro ativá-la no projeto do Google Cloud em que você quer usá-la:

  1. Acesse a página Biblioteca de APIs do console do Google Cloud.
    Acesse a página "Biblioteca de APIs"
  2. Selecione o projeto do Google Cloud que você quer usar para acessar o serviço.
  3. Na página "Biblioteca de APIs", clique em Ativar.
  4. Verifique se a conta de usuário tem o papel Administrador do uso do serviço.

Testar com curl

  1. Defina um alias prático para o shell para chamar as APIs REST do Google:

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
  2. Defina uma variável de ambiente PROJECT_ID com o identificador do projeto. Pode ser o ID ou o número do projeto:

    PROJECT_ID="my-project-id"
    
  3. Verifique se você fez login no "gcloud":

    gcloud auth login
    
  4. Liste as APIs e os serviços ativados neste projeto:

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

    Se você vir uma saída como esta, a configuração foi bem-sucedida:

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

Próximas etapas

Siga Serviços de listagem para listar as APIs e os serviços que estão ativados ou disponíveis nos seus projetos do Google Cloud.