Primeiros passos com a API Service Management

Esta página descreve como configurar seu ambiente de desenvolvimento para funcionar com a API Service Management. A abordagem mais simples para usar a Service Management API (além de usar a UI da Web do console do Google Cloud) e nossa recomendação para a maioria dos casos de uso operacionais é pela interface de linha de comando gcloud. Se for preciso programar sobre a API Service Management, recomendamos que você use uma de nossas bibliotecas de cliente fornecidas. Para testar a API sem configurar um ambiente de desenvolvimento de aplicativos completo, você pode seguir as instruções de configuração alternativas abaixo e usar o comando curl.

Observação: se você estiver criando um serviço usando o Cloud Endpoints, siga o guia de início rápido do Endpoints para saber como configurar e começar a usar a Service Management API para Cloud Endpoints.

Configuração com o gcloud

1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

3. Ative a API Service Management.

   Ative a API

4. Instale a CLI do Google Cloud.

5. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

6. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

7. Ative a API Service Management.

   Ative a API

8. Instale a CLI do Google Cloud.

9. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

Configuração para chamar a API diretamente

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

Configuração inicial

1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.
2. Instale a CLI do Google Cloud.

3. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

4. Crie ou selecione um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   • Crie um projeto do Google Cloud:

     gcloud projects create PROJECT_ID

     Substitua PROJECT_ID por um nome para o projeto do Google Cloud que você está criando.

   • Selecione o projeto do Google Cloud que você criou:

     gcloud config set project PROJECT_ID

     Substitua PROJECT_ID pelo nome do projeto do Google Cloud.

5. Ative a API Service Management:

   gcloud services enable servicemanagement.googleapis.com

6. Atribua os papéis à sua Conta do Google. Execute uma vez o seguinte comando para cada um dos seguintes papéis do IAM: roles/servicemanagement.admin

   gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE

   • Substitua PROJECT_ID pela ID do seu projeto.
   • Substitua EMAIL_ADDRESS pelo seu endereço de e-mail.
   • Substitua ROLE por cada papel individual.
7. Instale a CLI do Google Cloud.

8. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

9. Crie ou selecione um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   • Crie um projeto do Google Cloud:

     gcloud projects create PROJECT_ID

     Substitua PROJECT_ID por um nome para o projeto do Google Cloud que você está criando.

   • Selecione o projeto do Google Cloud que você criou:

     gcloud config set project PROJECT_ID

     Substitua PROJECT_ID pelo nome do projeto do Google Cloud.

10. Ative a API Service Management:

    gcloud services enable servicemanagement.googleapis.com

11. Atribua os papéis à sua Conta do Google. Execute uma vez o seguinte comando para cada um dos seguintes papéis do IAM: roles/servicemanagement.admin

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE

    • Substitua PROJECT_ID pela ID do seu projeto.
    • Substitua EMAIL_ADDRESS pelo seu endereço de e-mail.
    • Substitua ROLE por cada papel individual.

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. Tente listar os serviços acessíveis publicamente:

   $ 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.

   Observação: a configuração de serviço não entra em vigor automaticamente após o envio. Você precisa seguir a etapa 3 para implementar as configurações.

3. Consulte Como implementar configurações de serviço para fazer isso.