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 operacional, a maneira mais simples de ativar e desativar serviços é com 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, 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 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.