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 operacional, é por meio da 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.

Nota: Se você estiver criando um serviço usando o Cloud Endpoints, siga as instruções relevantes no Guia de início rápido do Endpoints para descobrir como configurar e começar a usar a API Service Management para o Cloud Endpoints.

Configuração com o gcloud

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Enable the Service Management API.

   Enable the API

4. Install the Google Cloud CLI.

5. To initialize the gcloud CLI, run the following command:

   gcloud init

6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

7. Enable the Service Management API.

   Enable the API

8. Install the Google Cloud CLI.

9. To initialize the gcloud CLI, run the following command:

   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. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
2. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

5. Enable the Service Management API:

   gcloud services enable servicemanagement.googleapis.com

6. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/servicemanagement.admin

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

   • Replace PROJECT_ID with your project ID.

   • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:[e-mail].

   • Replace ROLE with each individual role.
7. Install the Google Cloud CLI.

8. To initialize the gcloud CLI, run the following command:

   gcloud init

9. Create or select a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

10. Enable the Service Management API:

    gcloud services enable servicemanagement.googleapis.com

11. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/servicemanagement.admin

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

    • Replace PROJECT_ID with your project ID.

    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:[e-mail].

    • Replace ROLE with each individual role.

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

   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.