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 è una UI web utilizzata per eseguire il provisioning, configurare, gestire e monitorare i sistemi che utilizzano i prodotti Google Cloud. Utilizzi la console Google Cloud 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 di 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 (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 ulteriori informazioni, 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 di Service Usage.

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 le risorse e le applicazioni ospitate su Google Cloud. Ciò include la gcloud CLI. Il seguente link fornisce le istruzioni:

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

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 essere autorizzata l'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

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

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 le credenziali predefinite dell'applicazione e con le tue credenziali utente.

    Installa Google Cloud CLI.

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

    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.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

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

REST

Per utilizzare l'API REST in un ambiente di sviluppo locale, utilizzi le credenziali fornite 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 Autenticarsi 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 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 di Cloud Natural Language.

Informazioni sui ruoli

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