Primeiros passos

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, é possível usar a interface da linha de comando gcloud.
  • 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, primeiro você precisa ativá-la no projeto do Cloud em que você pretende usá-la:

  1. Acesse a página Biblioteca de APIs do Console do Google Cloud.
    Acesse a página "Biblioteca de APIs"
  2. Clique em Selecionar para escolher o projeto do Cloud que você quer usar para acessar o serviço.
  3. Na página "Biblioteca de APIs", clique em Ativar.

Crie uma conta de serviço

Crie uma conta de serviço e uma chave para executar os comandos curl nesta seção:

  1. Acesse a página Contas de serviço do Google Cloud.
    Acesse a página "Contas de serviço"
  2. Clique em Selecionar para escolher o projeto do Cloud que você quer usar para acessar o serviço.
  3. Crie uma conta de serviço. Para saber como criar contas de serviço, veja Como criar e gerenciar uma conta de serviço. Para seguir as instruções nesta seção, é preciso atribuir o papel roles/serviceusage.serviceUsageAdmin à conta de serviço. Consulte Como atribuir papéis a contas de serviço para saber como realizar essa ação.
  4. Acesse a página Credenciais da API no Cloud Console.
    Acessar a página "Credenciais da API"
  5. Crie uma chave de conta de serviço para sua nova conta e faça o download do arquivo de credencial JSON na sua máquina local. Os exemplos neste guia consideram que o caminho do arquivo é ~/credentials.json. Para saber como criar chaves de conta de serviço, consulte Como criar e gerenciar chaves de contas de serviço.
  6. Instale o oauth2l na sua máquina local para interagir com o sistema do Google OAuth.

Testar com curl

  1. Verifique primeiro sua configuração inicial:

    oauth2l header --json ~/credentials.json cloud-platform
    
  2. Depois de concluir o fluxo do OAuth, a saída deve ser parecida com esta:

    Authorization: Bearer y29.xxxxxxx
    
  3. Defina um alias conveniente para o shell para chamar as REST APIs do Google:

    alias gcurl='curl -H "$(oauth2l header --json ~/credentials.json cloud-platform userinfo.email)" -H "Content-Type: application/json"'
    
  4. Liste as APIs e os serviços disponíveis e ativos em um projeto:

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

    Se for exibida uma lista dos serviços, a configuração foi bem-sucedida.

A seguir

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