Guia de início rápido: configurar o Service Usage para um ambiente de desenvolvimento

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 operacionais, 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:não é necessário concluir as instruções nesta seção para 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 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. Selecione o projeto do 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 Service Usage.

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 seu projeto:

   PROJECT_ID="my-project-id"
   

3. Verifique se você fez login no "gcloud":

   gcloud auth login
   

4. Use gcloud para encontrar o número do projeto e salvá-lo em uma variável de ambiente:

   PROJECT_NUMBER=`gcloud projects list --filter="projectId=${PROJECT_ID}" --format="value(PROJECT_NUMBER)"`
   

5. Liste as APIs e os serviços ativados neste projeto:

   gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/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 ativados ou disponíveis nos seus projetos do Cloud.