Primeiros passos

Veja nesta página como configurar seu ambiente de desenvolvimento para usar a API Service Usage. Na maioria dos casos de uso operacionais, a maneira mais simples de ativar e desativar serviços é com o Console do Google Cloud Platform. Se você precisa criar scripts, pode usar a interface da linha de comando gcloud. Se precisar programar com a Service Usage API, recomendamos que você use uma das bibliotecas de clientes fornecidas. Para fazer testes com a API, siga as instruções de configuração alternativas deste guia e use o comando curl para testar a API sem configurar um ambiente de desenvolvimento de aplicativos completo.

Configuração para chamar a API diretamente

Nesta seção, você verá as etapas básicas necessárias para configurar o ambiente local e testar a Service Usage API com 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 GCP em que ela será usada:

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

Criar 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 Console do GCP.
    Acessar a página "Contas de serviço"
  2. Clique em Selecionar para escolher o projeto do GCP que você 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, você precisa conceder o papel roles/serviceusage.serviceUsageAdmin à conta de serviço. Para saber como atribuir papéis a contas de serviço, consulte este artigo.
  4. Acesse a página Credenciais da API no Console do GCP.
    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 supõem que o caminho do arquivo seja ~/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.

Próximas etapas

Consulte Como ativar e desativar serviços para realizar essas ações no seu projeto do GCP.