Introduzione all'API Service Management

Questa pagina descrive come configurare l'ambiente di sviluppo per l'utilizzo dell'API Service Management. L'approccio più semplice per utilizzare l'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 è tramite la interfaccia a riga di comando gcloud. Se devi programmare in base all'API Service Management, ti consigliamo di utilizzare una delle nostre librerie client fornite. Per eseguire esperimenti con l'API, puoi seguire le istruzioni di configurazione alternativa riportate di seguito e utilizzare il comando curl per testare l'API senza configurare un ambiente di sviluppo completo delle applicazioni.

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

    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.

    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 l'ambiente locale per eseguire esperimenti con l'API Service Management utilizzando il comando curl. È rivolto agli sviluppatori che devono programmare in base all'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.

    • 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:myemail@example.com.

    • Replace ROLE with each individual role.
    7.
  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.

    • 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:myemail@example.com.

    • Replace ROLE with each individual role.
    12.

Eseguire 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 stai creando un servizio gestito e non utilizzi Cloud Endpoints:

  1. Segui la sezione Creare ed eliminare 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 che descrivono le funzionalità utilizzate dal servizio.

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