Introduzione all'API Service Management

Questa pagina descrive come configurare l'ambiente di sviluppo per utilizzare l'API Service Management. L'approccio più semplice per utilizzare l'API Service Management (oltre a utilizzare l'interfaccia utente web della consoleGoogle Cloud ) e il nostro consiglio per la maggior parte dei casi d'uso operativi è tramite l'interfaccia a riga di comando di gcloud. Se devi programmare in base all'API Service Management, ti consigliamo di utilizzare una delle nostre librerie client. Per sperimentare l'API, puoi seguire le istruzioni di configurazione alternative riportate di seguito e utilizzare il comando curl per interagire con l'API senza configurare un ambiente di sviluppo di applicazioni completo.

Nota :se stai creando un servizio utilizzando Cloud Endpoints, devi seguire la guida rapida di Endpoints pertinente per scoprire come configurare e iniziare a utilizzare l'API Service Management per Cloud Endpoints.

Configurazione tramite gcloud

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.

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

Enable the Service Management API.

Enable the API

Install the Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

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

Enable the Service Management API.

Enable the API

Install the Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Configurazione per chiamare direttamente l'API

Questa sezione descrive i passaggi di base necessari per configurare l'ambiente locale per sperimentare l'API Service Management utilizzando il comando curl. È rivolto agli sviluppatori che devono programmare in base all'API Service Management.

Configurazione iniziale

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.
Install the Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla gcloud CLI con la tua identità federata.
Per inizializzare gcloud CLI, esegui questo comando:
gcloud init
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.
Enable the Service Management API:
gcloud services enable servicemanagement.googleapis.com
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 the following:
• PROJECT_ID: your project ID.
• USER_IDENTIFIER: the identifier for your user account—for example, [e-mail].
• ROLE: the IAM role that you grant to your user account.

Install the Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

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.

Enable the Service Management API:

gcloud services enable servicemanagement.googleapis.com

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 the following:

• PROJECT_ID: your project ID.
• USER_IDENTIFIER: the identifier for your user account—for example, [e-mail].
• ROLE: the IAM role that you grant to your user account.

Testare con curl

1. Definisci un alias shell pratico per chiamare le API REST di Google:

   $ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
   

2. Prova a elencare i servizi accessibili pubblicamente:

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

   Se vedi un elenco di servizi, la configurazione è riuscita.

Passaggi successivi

Se stai creando un servizio gestito e non utilizzi Cloud Endpoints:

1. Segui la procedura descritta in Creazione ed eliminazione di servizi per creare servizi gestiti. Verrà creata una risorsa di servizio gestito di primo livello.

2. Segui le istruzioni riportate in Gestione delle configurazioni dei servizi per inviare le configurazioni dei servizi per descrivere le funzionalità utilizzate dal servizio.

   Nota: la configurazione del servizio non ha effetto dopo l'invio. Devi seguire il passaggio 3 per implementare le configurazioni.

3. Segui la procedura descritta in Implementazione delle configurazioni dei servizi per implementare le configurazioni dei servizi.