Questa guida fornisce tutte le procedure di configurazione necessarie per iniziare a utilizzare Document AI.
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 Google Cloud prodotti. Utilizza 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 organizzi tutte le tue risorse Google Cloud e sia costituito dai seguenti componenti:
- Un insieme di collaboratori
- API abilitate (e altre risorse)
- Strumenti di monitoraggio
- Dati di fatturazione
- Autenticazione e controllo degli accessi
- Elaboratori di Document AI
Puoi creare un progetto o più progetti. Puoi utilizzare i progetti per organizzare le Google Cloud risorse 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'abilitazione 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. 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.
Località
Document AI ti offre un certo controllo su dove vengono archiviate ed elaborate le risorse per il tuo progetto. In particolare, quando crei un elaboratore, devi scegliere una posizione 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à dell'Unione Europea, i tuoi dati e le tue procedure vengono archiviati solo nell'Unione Europea.
Impostazione della posizione tramite API
Devi specificare la posizione del tuo elaboratore ogni volta che invii una richiesta di elaborazione utilizzando l'API. Ad esempio, se il tuo elaboratore è configurato per archiviare e elaborare i tuoi dati nell'Unione Europea, utilizza l'URI
eu-documentai.googleapis.com come segue:
Process |
|
batchProcess |
|
Installa la libreria client dell'API Document AI
Hai a disposizione tre opzioni per chiamare l'API Document AI:
- Librerie client supportate da Google (opzione consigliata)
- REST
- gRPC
Le librerie client sono disponibili per diversi linguaggi diffusi. Per informazioni sull'installazione delle librerie client, consulta Documentare le librerie client dell'API Document AI.
Installa e inizializza Google Cloud CLI
L'interfaccia a riga di comando gcloud fornisce 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 initConfigura 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 initLibrerie 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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init -
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 ulteriori informazioni, consulta Configurare l'ADC per un ambiente di sviluppo locale nella Google Cloud documentazione sull'autenticazione.
REST
Per utilizzare l'API REST in un ambiente di sviluppo locale, utilizza le credenziali fornite all'interfaccia a riga di comando gcloud.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud initPer ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione Google Cloud sull'autenticazione.
Per informazioni su come configurare l'autenticazione per un ambiente di produzione, consulta Set up Application Default Credentials for code running on Google Cloud nella Google Cloud documentazione sull'autenticazione.
Informazioni sui ruoli
Quando chiami un'API, Google Cloud è necessario che l'identità chiamante (qualsiasi persona, entità o processo applicabile e i relativi attributi definiti) abbia le autorizzazioni appropriate. Puoi concedere le autorizzazioni concedendo ruoli a un account utente o a un account di servizio. Per ulteriori informazioni, consulta la documentazione di Identity and Access Management (IAM).
Ai fini della prova dell'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 alle risorse del 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 di Document AI e Ruoli di 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 volere che questo progetto acceda ai file di input archiviati in un progetto diverso nella stessa organizzazione che ospita i processori Document AI.
Per consentire l'accesso tra progetti, devi concedere il ruolo Visualizzatore oggetti Storage
(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.
- Il progetto B è proprietario del bucket contenente i file di input per gli elaboratori Document AI.
Per rendere accessibili i file del progetto B al progetto A, devi concedere il ruolo
roles/storage.objectViewerVisualizzatore oggetti archiviazione per il bucket di input nel progetto B all'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 relativi processori. 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-02-14 UTC.