Primeiros passos com a API Service Management

Nesta página, você aprende a configurar o ambiente de desenvolvimento para trabalhar com a API Service Management. A abordagem mais simples para usar essa API, além de utilizar a IU da Web do Console do Google Cloud Platform, é pela interface da linha de comando gcloud, que é a nossa recomendação para a maioria dos casos de uso operacionais. Se for preciso programar sobre a API Service Management, recomendamos que você use uma de nossas bibliotecas de cliente fornecidas. Para fazer testes com a API, siga as instruções de configuração alternativas abaixo e use o comando curl para testar a API sem configurar um ambiente completo de desenvolvimento de aplicativos.

Configuração com o gcloud

  1. Faça login na sua Conta do Google.

    Se você ainda não tiver uma, inscreva-se.

  2. Selecione ou crie um projeto do GCP.

    Acessar a página Gerenciar recursos

  3. Ativar Service Management API.

    Ativar API

  4. Instale e inicialize o SDK do Cloud.

Configuração para chamar a API diretamente

Nesta seção, descrevemos as etapas básicas necessárias para configurar seu ambiente local visando testar a API Service Management usando o comando curl. Ela é destinada a desenvolvedores que precisam programar sobre a API Service Management.

Configuração inicial

  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 Google Cloud Platform 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. Para acompanhar as instruções nesta seção, você precisa conceder o papel roles/servicemanagement.admin à 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. Primeiro, verifique sua configuração inicial:

    $ oauth2l header --json ~/credentials.json cloud-platform
    
  2. Depois de concluir o fluxo do OAuth, a resposta deve ser similar a esta:

    Authorization: Bearer y29.xxxxxxx
    
  3. 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"'
    
  4. Tente listar os serviços acessíveis ao público:

    $ gcurl https://servicemanagement.googleapis.com/v1/services
    

    Se for exibida uma lista dos serviços, a configuração foi bem-sucedida.

Próximas etapas

Se você estiver criando um serviço gerenciado e não estiver usando o Cloud Endpoints:

  1. Consulte Como criar e excluir serviços para criar serviços gerenciados. Isso criará um recurso de serviço gerenciado de nível superior.
  2. Para enviar configurações de serviço que descrevam os recursos usados por ele, consulte Como gerenciar configurações de serviço.
  1. Consulte Como implementar configurações de serviço para fazer isso.
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Service Infrastructure