Configurazione e pulizia di Cloud Vision

Questa guida fornisce tutti i passaggi di configurazione necessari per iniziare a utilizzare Cloud Vision. Fornisce inoltre consigli su possibili misure di pulizia dopo aver provato o testato Cloud Vision.

Informazioni sulla Google Cloud Console

Console Google Cloud (consulta la documentazione, apri la console) è una UI web usata per eseguire il provisioning, la configurazione, la gestione e monitorare i sistemi che usano i prodotti Google Cloud. Puoi utilizzare la Google Cloud Console per configurare e gestire le risorse Vision.

Crea un progetto

Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto. che organizza tutte le risorse Google Cloud. Un progetto è composto da un insieme di collaboratori API (e altre risorse) abilitate, strumenti di monitoraggio, dati di fatturazione, e i controlli di autenticazione e accesso. Puoi creare un solo progetto, Oppure puoi creare più progetti e utilizzarle per organizzare le risorse Google Cloud gerarchia delle risorse. Quando crei un progetto, prendi nota dell'ID progetto. Ti servirà questo ID per effettuare chiamate API. Per ulteriori informazioni sui progetti, consulta 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 deve pagare per un 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 Vision per il progetto. Per ulteriori informazioni sull'abilitazione delle API, consulta la documentazione di Service Usage.

Enable the Vision API.

Enable the API

Installa e inizializza Google Cloud CLI

Se prevedi di utilizzare l'API Vision, devi installare e inizializzare Google Cloud CLI. gcloud CLI è un insieme di strumenti che puoi utilizzare per gestire le risorse e le applicazioni ospitate su Google Cloud.

Le istruzioni sono disponibili al seguente link:

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

gcloud init

Configurare l'autenticazione e il controllo dell'accesso

Se prevedi di utilizzare l'API Vision, devi configurare l'autenticazione. Qualsiasi applicazione client che utilizza l'API devono essere autenticati e autorizzati ad accedere alle risorse richieste. Questa sezione descrive importanti concetti di autenticazione e indica i passaggi per la configurazione. Per ulteriori informazioni, consulta Panoramica dell'autenticazione Google Cloud.

Autenticazione con gli account utente

Gli account utente sono l'opzione di autenticazione ottimale durante l'apprendimento dell'API Vision e per lo sviluppo locale. Puoi utilizzare il tuo account utente per autenticarti per le esecuzioni della riga di comando REST o le chiamate alla libreria client.

Autenticazione dell'account utente della riga di comando REST

Per eseguire l'autenticazione per le chiamate a riga di comando REST, utilizzi gcloud CLI. Il comando gcloud auth login ti consente di accedere a gcloud con il tuo account utente, operazione che deve essere eseguita prima di chiamare l'API. Il comando gcloud auth print-access-token viene utilizzato in tutti gli esempi di riga di comando REST in questa documentazione per autenticare le chiamate REST.

Per creare le credenziali utente per il tuo ambiente locale: 

gcloud auth login

Autenticazione dell'account utente della libreria client

Per eseguire l'autenticazione per le chiamate alla libreria client, utilizzi gcloud CLI. La gcloud auth application-default login il comando permette di accedere a gcloud per le credenziali predefinite dell'applicazione con il tuo account utente, da eseguire prima di chiamare l'API. La gcloud auth application-default set-quota-project per impostare la fatturazione e le quote del progetto relative alle chiamate API. Di solito si tratta dello stesso progetto utilizzato dal tuo agente. Fornisci l'ID progetto che hai creato nei passaggi precedenti.

La GOOGLE_APPLICATION_CREDENTIALS di variabile di ambiente non deve essere impostata per le credenziali predefinite dell'applicazione che devono essere usate dalle librerie client.

Per creare le credenziali predefinite dell'applicazione per il tuo ambiente locale: 

gcloud auth application-default login
gcloud auth application-default set-quota-project PROJECT_ID

Autenticazione con account di servizio

Gli account di servizio sono un'altra opzione di autenticazione che deve essere utilizzata solo in ambienti protetti come la produzione o l'implementazione. Un account di servizio fornisce le credenziali per le applicazioni, piuttosto che agli utenti finali. Gli account di servizio sono di proprietà dei progetti e puoi crearne molti per un progetto. Per ulteriori informazioni, vedi:

Controllo dell'accesso con i ruoli

Quando un'entità (account utente, account di servizio e così via) chiama un'API, Google Cloud richiede che l'entità disponga delle autorizzazioni appropriate. Puoi concedere le autorizzazioni concedendo i ruoli a un'entità. Per ulteriori informazioni, consulta la panoramica dei ruoli.

Se hai creato il progetto con il tuo account utente, il tuo account utente dispone del ruolo di proprietario di base per il progetto. Questo ruolo fornisce l'accesso per chiamare qualsiasi API per il progetto. Tuttavia, se il progetto è stato creato da un altro account, è possibile che tu debba concedere dei ruoli al tuo account utente prima di poter chiamare l'API.

Installa la libreria client dell'API Vision

Hai a disposizione tre opzioni per chiamare l'API Vision:

Le librerie client sono disponibili per diversi linguaggi diffusi. Per informazioni sull'installazione delle librerie client, consulta Librerie client dell'API Vision.

Esegui la pulizia

Dopo aver configurato e provato o testato Vision, ti consigliamo di eliminare le risorse che hai creato:

  • Potresti voler chiudere il progetto.
  • Se hai chiamato gcloud auth login, le credenziali vengono memorizzate nella directory utente del computer. Ti consigliamo di eliminare queste credenziali chiamando: 
    gcloud auth revoke
  • Se hai chiamato gcloud auth application-default login, le credenziali vengono memorizzate nella directory utente del computer. Ti consigliamo di eliminare queste credenziali chiamando: 
    gcloud auth application-default revoke