Introduzione all'API Service Management

In questa pagina viene descritto come configurare l'ambiente di sviluppo per utilizzarlo l'API Service Management. L'approccio più semplice all'utilizzo l'API Service Management (oltre al semplice utilizzo Console Google Cloud UI web) e il nostro consiglio per la maggior parte dei casi d'uso operativi è tramite gcloud interfaccia a riga di comando. Se devi programmare in base all'API Service Management, ti consigliamo puoi utilizzare uno dei nostri librerie client. Per fare esperimenti con l'API, puoi seguire le istruzioni di configurazione alternative di seguito e utilizza il comando curl per sperimentare con l'API senza configurare un di sviluppo delle applicazioni.

Nota: se crei un servizio utilizzando Cloud Endpoints, devono seguire le Guida rapida degli endpoint per scoprirlo configurare e iniziare a utilizzare l'API Service Management per Cloud Endpoints.

Configura con 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

Configurazione per chiamare direttamente l'API

Questa sezione descrive i passaggi di base necessari per configurare il tuo per sperimentare l'API Service Management utilizzando Comando curl. È rivolto agli sviluppatori che devono programmare contro l'API Service Management.

Impostazione iniziale

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.

Esegui il test 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 al pubblico:

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

   Se viene visualizzato un elenco di servizi, la configurazione è andata a buon fine.

Passaggi successivi

Se crei un servizio gestito e non stai utilizzando Cloud Endpoints:

1. Segui la sezione Creare ed eliminare servizi per creare servizi gestiti. Questo creerà un servizio gestito di primo livello risorsa.

2. Consulta la sezione Gestione delle configurazioni dei servizi. per inviare configurazioni del servizio per descrivere le funzionalità usato dal servizio.

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

3. Segui le istruzioni riportate in Implementazione delle configurazioni dei servizi per eseguire l'implementazione delle configurazioni dei servizi.