Configurare l'API Service Usage per un ambiente di sviluppo

Questa pagina descrive come configurare l'ambiente di sviluppo per utilizzare l'API Service Usage.

  • Per la maggior parte dei casi d'uso operativi, il modo più semplice per abilitare e disabilitare i servizi è utilizzare la Google Cloud console.
  • Se devi creare script, puoi utilizzare Google Cloud CLI.
  • Se devi programmare con l'API Service Usage, utilizza una delle librerie client.
  • Per sperimentare con l'API, puoi seguire le istruzioni di configurazione alternative in questa guida e utilizzare il comando curl per testare l'API senza configurare un ambiente di sviluppo completo dell'applicazione.

Configurare la chiamata diretta all'API

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

Abilitare l'API Service Usage

Per utilizzare l'API Service Usage, devi prima abilitarla nel tuo Google Cloud progetto.

  1. Accedi al tuo Google Cloud account. 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 senza costi 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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Enable the Service Usage API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Enable the Service Usage API.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  6. Assicurati che al tuo account utente sia stato concesso il ruolo Amministratore di Service Usage.

Testare con curl

  1. Imposta una variabile di ambiente PROJECT_ID con l'identificatore del tuo progetto:

    PROJECT_ID=PROJECT_ID
    

    Sostituisci PROJECT_ID con l'ID o il numero del tuo Google Cloud progetto.

  2. Assicurati di aver eseguito l'accesso a "gcloud":

    gcloud auth login
    
  3. Elenca le API e i servizi abilitati in questo progetto:

    curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://serviceusage.googleapis.com/v1/projects/${PROJECT_ID}/services?filter=state:ENABLED&fields=services.config.title,services.config.name"
    

    Se vedi un output simile a questo, la configurazione è andata a buon fine:

    {
    "services": [
      {
        "config": {
          "name": "bigquery.googleapis.com",
          "title": "BigQuery API"
        }
      },
      {
        "config": {
          "name": "bigquerystorage.googleapis.com",
          "title": "BigQuery Storage API"
        }
      },
      ...
    

Passaggi successivi

Per elencare le API e i servizi abilitati o disponibili nei tuoi Google Cloud progetti, consulta Elencare i servizi.