Guida rapida: configura l'API Natural Language

Questa guida fornisce tutte le procedure di configurazione necessarie per iniziare a utilizzare Natural Language.

Informazioni sulla console Google Cloud

La consoleGoogle Cloud è una UI web utilizzata per eseguire il provisioning, configurare, gestire e monitorare i sistemi che utilizzano i prodotti Google Cloud . Utilizzi la Google Cloud console per configurare e gestire le risorse di Natural Language.

Crea un progetto

Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto.

che organizza tutte le risorse Google Cloud . Un progetto è costituito dai seguenti componenti:

  • un insieme di collaboratori
  • API abilitate (e altre risorse)
  • strumenti di monitoraggio
  • dati di fatturazione aggiornati
  • autenticazione e controlli dell'accesso

Puoi creare un progetto o più progetti e utilizzarli per organizzare le tue risorse Google Cloud in una gerarchia delle risorse. Per saperne di più sui progetti, consulta la documentazione di Resource Manager.

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

Abilita fatturazione

Un account di fatturazione viene utilizzato per definire chi paga per un determinato insieme di risorse e può essere collegato a uno o più progetti. L'utilizzo del progetto viene addebitato all'account di fatturazione collegato. Nella maggior parte dei casi, la fatturazione viene configurata quando crei un progetto. Per saperne di più, consulta la documentazione sulla fatturazione.

Verify that billing is enabled for your Google Cloud project.

Abilita l'API

Devi abilitare l'API Cloud Natural Language per il tuo progetto. Per ulteriori informazioni sull'attivazione delle API, consulta la documentazione sull'utilizzo del servizio.

Enable the Cloud Natural Language API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Installa e inizializza gcloud CLI

Se prevedi di utilizzare l'API Natural Language, devi installare e inizializzare gcloud CLI. gcloud CLI è un insieme di strumenti che puoi utilizzare per gestire risorse e applicazioni ospitate su Google Cloud. Ciò include la gcloud CLI. Il seguente link fornisce le istruzioni:

Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command: 

gcloud init

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

Configura l'autenticazione

Qualsiasi applicazione client che utilizza l'API deve essere autenticata e deve disporre dell'accesso alle risorse richieste. La configurazione dell'autenticazione dipende dal fatto che tu stia lavorando in un ambiente di sviluppo locale o configurando un ambiente di produzione. Per saperne di più, consulta Configurare le credenziali predefinite dell'applicazione.

Select the tabs for how you plan to access the API:

gcloud

Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command: 

gcloud init

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

Librerie client

Per utilizzare le librerie client in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.

    Install the Google Cloud CLI.

    If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    If you're using a local shell, then create local authentication credentials for your user account: 

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione di Google Cloud .

REST

Per utilizzare l'API REST in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

    Install the Google Cloud CLI.

    If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Per informazioni sulla configurazione dell'autenticazione per un ambiente di produzione, consulta Set up Application Default Credentials for code running on Google Cloud nella documentazione sull'autenticazione di Google Cloud .

Installa la libreria client dell'API Natural Language

Hai tre opzioni per chiamare l'API Natural Language:

Le librerie client sono disponibili per diversi linguaggi di programmazione più diffusi. Per informazioni sull'installazione delle librerie client, consulta Librerie client Cloud Natural Language.

Ruoli IAM

Per ottenere le autorizzazioni necessarie per accedere all'API Cloud Natural Language, chiedi all'amministratore di concederti il ruolo IAM Service Usage Consumer (roles/serviceusage.serviceUsageConsumer) nel tuo progetto quota. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.