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 console Google Cloud è un'interfaccia utente web utilizzata per eseguire il provisioning, configurare, gestire e monitorare i sistemi che utilizzano i prodotti Google Cloud. Utilizza la console Google Cloud per configurare e gestire le risorse di linguaggio naturale.

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 degli accessi

Puoi creare un progetto oppure 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.

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

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 ulteriori informazioni, consulta la documentazione relativa alla fatturazione.

Make sure 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'abilitazione delle API, consulta la documentazione di Service Usage.

Enable the Cloud Natural Language API.

Enable the API

Installa e inizializza la 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 le risorse e le applicazioni ospitate su Google Cloud. È inclusa la gcloud CLI. Le istruzioni sono disponibili al seguente link:

Install the Google Cloud CLI, then initialize it by running the following command: 

gcloud init

Configura l'autenticazione

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

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

gcloud

Install the Google Cloud CLI, then initialize it by running the following command: 

gcloud init

Librerie client

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

  1. Install the Google Cloud CLI.

  2. To initialize the gcloud CLI, run the following command: 

    gcloud init

  3. 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 Configurare l'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, utilizza le credenziali fornite all'interfaccia alla gcloud CLI.

    Install the Google Cloud CLI, then initialize it by running the following command: 

    gcloud init

Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di 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 diffusi. Per informazioni sull'installazione delle librerie client, consulta Librerie client di Cloud Natural Language.

Informazioni sui ruoli

Non è richiesto alcun ruolo per accedere all'API Cloud Natural Language. Gli utenti o le applicazioni autenticati possono effettuare chiamate all'API, indipendentemente dalle loro autorizzazioni.