Configurar 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 Google Cloud CLI.
• 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.

Observação: você não precisa concluir as instruções desta seção se quiser listar, ativar ou desativar serviços usando o console do Google Cloud ou a interface de linha de comando gcloud.

Ativar a API Service Usage

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

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 Como listar serviços para listar as APIs e os serviços ativados ou disponíveis nos seus projetos do Google Cloud.