Dopo aver configurato il tuo Google Cloud account e creato un processore, puoi inviare una richiesta al tuo processore Document AI.
Il codice utilizzato per inviare la richiesta è uguale per tutti i processori. Vedi differenze nel funzionamento del processore nelle informazioni che ogni processore produce.
Se utilizzi la versione v1API di Document AI o la console Google Cloud , puoi inviare richieste di elaborazione a quella versione specifica del processore. Se non
specifichi una versione del processore, viene utilizzata quella predefinita.
Per saperne di più, consulta Gestione delle versioni del processore.
Elaborazione online
Le richieste online (sincrone) ti consentono di inviare un singolo documento per l'elaborazione.
Document AI elabora immediatamente la richiesta e restituisce un document.
Inviare una richiesta a un responsabile del trattamento
I seguenti esempi di codice mostrano come inviare una richiesta a un processore.
REST
Questo esempio mostra come fornire i contenuti del documento (contenuti grezzi del documento in byte
tramite una stringa con codifica base64) nell'oggetto rawDocument.
In alternativa, puoi anche specificare inlineDocument, che è lo stesso formato JSON Document restituito da Document AI. Ciò ti consente di concatenare le richieste passando avanti e indietro lo stesso formato
(ad esempio, se classifichi un documento e poi ne estrai il contenuto).
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- LOCATION: la posizione del tuo processore, ad esempio:
us- Stati Unitieu- Unione Europea
- PROJECT_ID: l'ID progetto Google Cloud .
- PROCESSOR_ID: l'ID del tuo processore personalizzato.
- skipHumanReview: Un valore booleano per disattivare la revisione umana (supportato solo dai processori Human-in-the-Loop).
true- skips human reviewfalse: attiva la revisione da parte di persone fisiche (impostazione predefinita)
- MIME_TYPE†: una delle opzioni valide per il tipo MIME.
- IMAGE_CONTENT†: uno dei contenuti validi
del documento in linea, rappresentati come
un flusso di byte. Per le rappresentazioni JSON, la codifica base64 (stringa ASCII) dei dati immagine binari. Questa stringa dovrebbe essere simile alla
seguente:
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- FIELD_MASK: specifica quali campi includere nell'output
Document. Si tratta di un elenco separato da virgole di nomi completi dei campi nel formatoFieldMask.- Esempio:
text,entities,pages.pageNumber
- Esempio:
- INDIVIDUAL_PAGES: un elenco di singole pagine da elaborare.
† Questi contenuti possono essere specificati anche utilizzando contenuti codificati in base64 nell'oggetto
inlineDocument.
Metodo HTTP e URL:
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:process
Corpo JSON della richiesta:
{
"skipHumanReview": skipHumanReview,
"rawDocument": {
"mimeType": "MIME_TYPE",
"content": "IMAGE_CONTENT"
},
"fieldMask": "FIELD_MASK",
"processOptions": {
"individualPageSelector" {
"pages": [INDIVIDUAL_PAGES]
}
}
}
Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:process"
PowerShell
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:process" | Select-Object -Expand Content
Se la richiesta riesce, il server restituisce un codice di stato HTTP 200 OK e la
risposta in formato JSON. Il corpo della risposta contiene un'istanza di
Document.
Inviare una richiesta a una versione del processore
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- LOCATION: la posizione del tuo processore, ad esempio:
us- Stati Unitieu- Unione Europea
- PROJECT_ID: l'ID progetto Google Cloud .
- PROCESSOR_ID: l'ID del tuo processore personalizzato.
- PROCESSOR_VERSION: l'identificatore della versione del processore. Per saperne di più, consulta Selezionare una versione del processore. Ad esempio:
pretrained-TYPE-vX.X-YYYY-MM-DDstablerc
- skipHumanReview: Un valore booleano per disattivare la revisione umana (supportato solo dai processori Human-in-the-Loop).
true- salta la revisione umanafalse: attiva la revisione da parte di persone fisiche (impostazione predefinita)
- MIME_TYPE†: una delle opzioni valide per il tipo MIME.
- IMAGE_CONTENT†: uno dei contenuti validi
del documento in linea, rappresentati come
un flusso di byte. Per le rappresentazioni JSON, la codifica base64 (stringa ASCII) dei dati immagine binari. Questa stringa dovrebbe essere simile alla
seguente:
/9j/4QAYRXhpZgAA...9tAVx/zDQDlGxn//2Q==
- FIELD_MASK: specifica quali campi includere nell'output
Document. Si tratta di un elenco separato da virgole di nomi completi dei campi nel formatoFieldMask.- Esempio:
text,entities,pages.pageNumber
- Esempio:
† Questi contenuti possono essere specificati anche utilizzando contenuti codificati in base64 nell'oggetto
inlineDocument.
Metodo HTTP e URL:
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:process
Corpo JSON della richiesta:
{
"skipHumanReview": skipHumanReview,
"rawDocument": {
"mimeType": "MIME_TYPE",
"content": "IMAGE_CONTENT"
},
"fieldMask": "FIELD_MASK"
}
Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:process"
PowerShell
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:process" | Select-Object -Expand Content
Se la richiesta riesce, il server restituisce un codice di stato HTTP 200 OK e la
risposta in formato JSON. Il corpo della risposta contiene un'istanza di
Document.
C#
Per saperne di più, consulta la documentazione di riferimento dell'API Document AI C#.
Per eseguire l'autenticazione in Document AI, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Document AI Java.
Per eseguire l'autenticazione in Document AI, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per saperne di più, consulta la documentazione di riferimento dell'API Document AI Node.js.
Per eseguire l'autenticazione in Document AI, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.