Questa guida contiene tutte le procedure di configurazione necessarie per iniziare a utilizzare Document AI.
Informazioni sulla console Google Cloud
Google Cloud console è un'interfaccia utente 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 Document AI.
Crea un progetto
Per utilizzare i servizi forniti da Google Cloud, devi creare un progetto che organizza tutte le tue risorse Google Cloud e che è composto dai seguenti componenti:
- Un insieme di collaboratori
- API abilitate (e altre risorse)
- Strumenti di monitoraggio
- Dati di fatturazione
- Autenticazione e controlli dell'accesso
- Processori Document AI
Puoi creare un progetto o più progetti. Puoi utilizzare i tuoi progetti per organizzare le risorse di 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.
Abilita l'API
Devi abilitare l'API Document AI per il tuo progetto. Per ulteriori informazioni sull'attivazione delle API, consulta la documentazione di Service Usage.
Enable the Document AI API.
Abilita fatturazione
Un account di fatturazione definisce chi paga per un determinato insieme di risorse. Gli account di fatturazione possono essere collegati a uno o più progetti. L'utilizzo del progetto viene addebitato all'account di fatturazione collegato. Configuri la fatturazione quando crei un progetto. Per ulteriori informazioni, consulta la documentazione sulla fatturazione.
Verify that billing is enabled for your Google Cloud project.
Località
Document AI ti offre un certo controllo sul luogo in cui le risorse del tuo progetto vengono archiviate ed elaborate. In particolare, quando crei un processore, devi scegliere una località in cui archiviare ed elaborare i dati. Per impostazione predefinita, Document AI archivia ed elabora le risorse in una località degli Stati Uniti. Se scegli la località Unione Europea, i tuoi dati e processi vengono archiviati solo nell'Unione Europea.
Impostazione della posizione tramite l'API
Devi specificare la posizione del processore ogni volta che invii una richiesta di elaborazione utilizzando l'API. Ad esempio, se il tuo responsabile del trattamento è configurato per archiviare e trattare i tuoi dati nell'Unione Europea, utilizza l'URI eu-documentai.googleapis.com nel seguente modo:
Process |
|
batchProcess |
|
Installa la libreria client dell'API Document AI
Hai tre opzioni per chiamare l'API Document AI:
- Librerie client supportate da Google (consigliate)
- REST
- gRPC
Le librerie client sono disponibili per diversi linguaggi di programmazione più diffusi. Per informazioni sull'installazione delle librerie client, consulta Librerie client dell'API Document AI.
Installa e inizializza Google Cloud CLI
La CLI gcloud fornisce un insieme di strumenti che puoi utilizzare per gestire le risorse e le applicazioni ospitate su Google Cloud.
Il seguente link fornisce le istruzioni:
Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando:
gcloud initSe utilizzi un provider di identità (IdP) esterno, devi prima accedere alla 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 tab for how you plan to use the samples on this page:
gcloud
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
C#
Per utilizzare gli esempi di .NET questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla 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 Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione Google Cloud .
Vai
Per utilizzare gli esempi di Go questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla 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 Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione Google Cloud .
Java
Per utilizzare gli esempi di Java questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla 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 Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione Google Cloud .
Node.js
Per utilizzare gli esempi di Node.js questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla 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 Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione Google Cloud .
PHP
Per utilizzare gli esempi di PHP questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla 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 Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione Google Cloud .
Python
Per utilizzare gli esempi di Python questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla 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 Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione Google Cloud .
Ruby
Per utilizzare gli esempi di Ruby questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere alla 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 Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione Google Cloud .
REST
Per utilizzare gli esempi di API REST in questa pagina 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 alla 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 .
Informazioni sui ruoli
Quando si chiama un'API, Google Cloud richiede che l'identità (qualsiasi persona, entità o processo applicabile e i relativi attributi definiti) disponga delle autorizzazioni appropriate. Puoi concedere le autorizzazioni assegnando ruoli a un account utente o a un account di servizio. Per ulteriori informazioni, consulta la documentazione di Identity and Access Management (IAM).
Per provare l'API Document AI, puoi utilizzare il ruolo Progetto > Proprietario nei passaggi riportati di seguito. Il ruolo Progetto > Proprietario concede all'account di servizio l'autorizzazione completa per le risorse nel tuo progetto. Se la tua richiesta non richiede autorizzazioni complete, puoi specificare un ruolo più restrittivo utilizzando la console.Google Cloud Per un elenco di autorizzazioni e ruoli per Document AI, consulta Autorizzazioni Document AI e Ruoli Document AI. Per informazioni sulla gestione delle autorizzazioni utilizzando i ruoli IAM, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Configurazione dell'accesso ai file tra progetti
Quando configuri il processore Document AI in un progetto, potresti voler che questo progetto acceda ai file di input archiviati in un altro progetto della stessa organizzazione che ospita i processori Document AI.
Per consentire l'accesso tra progetti, devi concedere il ruolo Storage Object Viewer (roles/storage.objectViewer) all'account di servizio Document AI predefinito, come mostrato nella figura seguente.
Esempio
- Supponiamo che il progetto A ospiti i processori Document AI e, facoltativamente, un bucket in cui viene scritto l'output del processore.
- Project B è proprietario del bucket che contiene i file di input per i processori Document AI.
Per rendere accessibili i file nel progetto B al progetto A, devi concedere il ruolo Storage Object Viewer (
roles/storage.objectViewer) per il bucket di input nel progetto B al account di servizio Document AI del progetto A.
Per saperne di più su IAM e Storage Object Viewer, consulta Ruoli IAM per Cloud Storage.
Service account integrati
Un account di servizio Document AI segue questa convenzione di denominazione:
service-{project number}@gcp-sa-prod-dai-core.iam.gserviceaccount.com
Esempio: service-361747088407@gcp-sa-prod-dai-core.iam.gserviceaccount.com
Passaggi successivi: casi d'uso
Dopo aver attivato l'API Document AI, è possibile creare e utilizzare i processori Document AI. Il tipo di processore migliore dipende dal tuo caso d'uso.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-18 UTC.