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 Google Cloud console è 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 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 risorse Google Cloud in una gerarchia delle risorse. Per saperne di più sui progetti, consulta la documentazione di Resource Manager.

Nella console Google Cloud , nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud .

Ruoli richiesti per selezionare o creare un progetto

  • Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
  • Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

Vai al selettore di progetti

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 durante la creazione di un progetto. Per saperne di più, consulta la documentazione sulla fatturazione.

Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .

Abilita l'API

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

Abilita l'API Cloud Natural Language, se non è già abilitata.

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

Abilitare l'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 gcloud CLI. Il seguente link fornisce le istruzioni:

Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente: 

gcloud init

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

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.

Seleziona le schede relative alla modalità di accesso all'API:

gcloud

Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente: 

gcloud init

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

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.

  1. Installa Google Cloud CLI.

  2. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  3. Se utilizzi una shell locale, crea le credenziali di autenticazione locali per il tuo account utente: 

    gcloud auth application-default login

    Non è necessario eseguire questa operazione se utilizzi Cloud Shell.

    Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.

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.

    Installa Google Cloud CLI.

    Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

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 Configura le Credenziali predefinite dell'applicazione per il codice in esecuzione su 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 diffusi. Per informazioni sull'installazione delle librerie client, consulta Librerie client di 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.