Esta página foi traduzida pela API Cloud Translation.
Switch to English

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. Selecione o projeto do Cloud que você quer usar para acessar o serviço.
  3. Na página "Biblioteca de APIs", clique em Ativar.

Configurar autorização

Para autorizar a API Service Usage a acessar seu projeto do Cloud, faça o seguinte:

  1. Crie uma conta de serviço.
    1. Acesse a página Contas de serviço do Console do Cloud.
      Acesse a página "Contas de serviço"
    2. Selecione 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.
  2. Conceda à nova conta de serviço o papel Administrador do Service Usage. Para saber como atribuir papéis a contas de serviço, consulte este artigo.
  3. Configure sua máquina local.

    1. Acesse a página Credenciais da API no Console do Cloud.
      Acessar a página Credenciais da API
    2. 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.
    3. Instale o oauth2l na sua máquina local para interagir com o sistema do Google OAuth.
    4. Opcionalmente, use oauth2l para criar um token do portador usando seu arquivo de credencial. Isso verifica se a configuração de OAuth está correta e se o arquivo de credencial da sua conta de serviço é válido:

          oauth2l header --json ~/credentials.json cloud-platform userinfo.email
      

      Quando bem-sucedido, a saída é semelhante a esta:

          Authorization: Bearer y29.xxxxxxx
      

Testar com curl

  1. Defina um alias prático para o shell para chamar as APIs REST do Google:

    alias gcurl='curl -H "$(oauth2l header --json ~/credentials.json cloud-platform userinfo.email)" -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 seu projeto e salvá-lo em uma variável de ambiente:

    PROJECT_NUMBER=`gcloud projects list --filter="${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 um resultado como este, 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.