Introduzione all'API Service Management

In questa pagina viene descritto come configurare l'ambiente di sviluppo per il funzionamento con l'API Service Management. L'approccio più semplice all'utilizzo dell'API Service Management (oltre all'utilizzo dell'interfaccia utente web della console Google Cloud) e il nostro consiglio per la maggior parte dei casi d'uso operativi, consiste nell'utilizzare l'gcloud interfaccia a riga di comando. Se devi programmare tramite l'API Service Management, ti consigliamo di utilizzare una delle nostre librerie client fornite. Per sperimentare l'API, puoi seguire le istruzioni di configurazione alternative riportate di seguito e utilizzare il comando curl per giocare con l'API senza configurare un ambiente di sviluppo dell'applicazione completo.

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

Configurazione mediante gcloud

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

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. Attiva l'API Service Management.

   Abilita l'API

4. Installa Google Cloud CLI.

5. Per initialize gcloud CLI, esegui questo comando:

   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. Attiva l'API Service Management.

   Abilita l'API

8. Installa Google Cloud CLI.

9. Per initialize gcloud CLI, esegui questo comando:

   gcloud init

Configura per chiamare direttamente l'API

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

Impostazione iniziale

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
2. Installa Google Cloud CLI.

3. Per initialize gcloud CLI, esegui questo comando:

   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. Attiva l'API Service Management.

   gcloud services enable servicemanagement.googleapis.com

6. Concedi i ruoli al tuo Account Google. Esegui questo comando una volta per ciascuno dei seguenti ruoli IAM: roles/servicemanagement.admin

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

   • Sostituisci PROJECT_ID con l'ID progetto.
   • Sostituisci EMAIL_ADDRESS con il tuo indirizzo email.
   • Sostituisci ROLE con ogni singolo ruolo.
7. Installa Google Cloud CLI.

8. Per initialize gcloud CLI, esegui questo comando:

   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. Attiva l'API Service Management.

    gcloud services enable servicemanagement.googleapis.com

11. Concedi i ruoli al tuo Account Google. Esegui questo comando una volta per ciascuno dei seguenti ruoli IAM: roles/servicemanagement.admin

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

    • Sostituisci PROJECT_ID con l'ID progetto.
    • Sostituisci EMAIL_ADDRESS con il tuo indirizzo email.
    • Sostituisci ROLE con ogni singolo ruolo.

Testa con curl

1. Definisci un pratico alias shell 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 servizi accessibili pubblicamente:

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

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

Passaggi successivi

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

1. Segui la sezione Creazione ed eliminazione dei servizi per creare i servizi gestiti. Verrà creata una risorsa di servizio gestito di primo livello.

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

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

3. Segui Implementazione delle configurazioni del servizio per implementare le configurazioni del servizio.