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. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

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. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

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. Crea o seleziona un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   • Crea un progetto Google Cloud:

     gcloud projects create PROJECT_ID

     Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

   • Seleziona il progetto Google Cloud che hai creato:

     gcloud config set project PROJECT_ID

     Sostituisci PROJECT_ID con il nome del tuo progetto Google Cloud.

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. Crea o seleziona un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   • Crea un progetto Google Cloud:

     gcloud projects create PROJECT_ID

     Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

   • Seleziona il progetto Google Cloud che hai creato:

     gcloud config set project PROJECT_ID

     Sostituisci PROJECT_ID con il nome del tuo progetto Google Cloud.

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.