Gestione delle versioni del processore

Le nuove versioni vengono rilasciate per vari motivi, ad esempio per migliorare l'accuratezza, aumentare la disponibilità e supportare nuovi elementi del documento, come i segni di selezione.

Poiché Document AI è basato sull'AI generativa, le versioni future utilizzano nuovi foundation model, così potrai usufruire dei miglioramenti dell'AI generativa.

Man mano che miglioriamo i modelli di base, i modelli di base precedenti vengono ritirati. Allo stesso modo, le versioni del processore vengono ritirate sei mesi dopo il rilascio di nuove versioni.

Un processore può avere una delle seguenti versioni:

Questa pagina descrive come viene eseguito il controllo delle versioni dei processori e come visualizzare e selezionare una determinata versione.

managing-processor-versions-1

Panoramica delle versioni del processore

Esistono due categorie di versioni del processore:

  • Le versioni Google sono stabili (per i casi d'uso di produzione) o candidate al rilascio (sperimentali con le funzionalità più recenti).
  • Le versioni utente vengono create da te per personalizzare le previsioni per i tuoi documenti e hanno ID versione alfanumerici.

Versioni di Google

Ogni versione di Google è identificata da un ID versione, ad esempio pretrained-TYPE-vX.X-YYYY-MM-DD. Ogni versione del processore offerta da Google è denominata Google Stable o Google Release Candidate (RC).

Versioni stabili di Google

Le versioni stabili sono di qualità elevata e pronte all'uso.

  • Google dà la priorità alla stabilità del comportamento del processore, ma include comunque correzioni critiche.
  • Le versioni stabili precedenti di Google vengono ritirate sei mesi dopo il rilascio della versione stabile più recente, come illustrato nella figura seguente.

managing-processor-versions-2

Candidati per la release (RC) di Google

I candidati per le release sono sperimentali e vengono aggiornati regolarmente con le ultime funzionalità. Non si tratta di versioni di qualità elevata e la loro stabilità potrebbe variare.

Versioni personalizzate

Le versioni personalizzate sono le versioni del processore che puoi creare in base ai tuoi documenti per personalizzare le previsioni. Le versioni personalizzate hanno un'icona Type, che mostra il tipo di modello utilizzato per le previsioni. Se crei una versione utilizzando un foundation model (creando una versione o eseguendo il fine-tuning), il tipo è AI generativa. Se crei una versione del processore addestrando un modello personalizzato più piccolo (basato su modello o su modello), il tipo è Personalizzato. Se crei versioni del processore, decidi il nome e l'ID.

Versioni di base

Se crei una versione del processore, la "versione di base" mostra la versione di Google che alimenta la tua versione utente personalizzata. La versione di base determina il ciclo di vita della versione utente. Devi prendere decisioni su come gestire il ciclo di vita della tua versione utente personalizzata.

Versioni stabili del processore disponibili

Puoi esaminare le versioni stabili del processore disponibili per i diversi tipi di processore nelle tabelle seguenti.

Estrattore personalizzato Data di uscita Data di ritiro
pretrained-foundation-model-v1.4-2025-02-05 5 febbraio 2025 Non applicabile
pretrained-foundation-model-v1.5-2025-05-05 5 maggio 2025 Non applicabile
Analizzatore sintattico di moduli Data di uscita Data di ritiro
pretrained-form-parser-v1.0-2020-09-23 23 settembre 2020 Non applicabile
pretrained-form-parser-v2.0-2022-11-10 10 novembre 2022 Non applicabile
Parser del layout Data di uscita Data di ritiro
pretrained-layout-parser-v1.0-2024-06-03 3 giugno 2024 Non applicabile
Analizzatore estratto conto bancario Data di uscita Data di ritiro
pretrained-bankstatement-v1.0-2021-08-08 8 agosto 2021 Non applicabile
pretrained-bankstatement-v1.1-2021-08-13 13 agosto 2021 Non applicabile
pretrained-bankstatement-v2.0-2021-12-10 10 dicembre 2021 Non applicabile
pretrained-bankstatement-v3.0-2022-05-16 16 maggio 2022 Non applicabile
Analizzatore W2 Data di uscita Data di ritiro
pretrained-w2-v1.0-2020-10-01 1° ottobre 2020 31 marzo 2024
pretrained-w2-v1.1-2022-01-27 27 gennaio 2022 31 marzo 2024
pretrained-w2-v1.2-2022-01-28 28 gennaio 2022 Non applicabile
pretrained-w2-v2.1-2022-06-08 8 giugno 2022 Non applicabile
Analizzatore sintattico di passaporti statunitensi Data di uscita Data di ritiro
pretrained-us-passport-v1.0-2021-06-14 14 giugno 2021 Non applicabile
Analizzatore sintattico delle utenze Data di uscita Data di ritiro
pretrained-utility-v1.1-2021-04-09 9 aprile 2021 Non applicabile
Parser di verifica dei documenti di identità Data di uscita Data di ritiro
pretrained-id-proofing-v1.0-2022-10-03 3 ottobre 2022 Non applicabile
Analizzatore busta paga Data di uscita Data di ritiro
pretrained-paystub-v1.0-2021-03-19 19 marzo 2021 Non applicabile
pretrained-paystub-v1.1-2021-08-13 13 agosto 2021 Non applicabile
pretrained-paystub-v1.2-2021-12-10 10 dicembre 2021 Non applicabile
pretrained-paystub-v2.0-2022-07-22 22 luglio 2022 Non applicabile
Analizzatore sintattico di patenti di guida statunitensi Data di uscita Data di ritiro
pretrained-us-driver-license-v1.0-2021-06-14 14 giugno 2021 Non applicabile
Analizzatore sintattico delle spese Data di uscita Data di ritiro
pretrained-expense-v1.1-2021-04-09 9 aprile 2024 Non applicabile
Analizzatore sintattico delle fatture Data di uscita Data di ritiro
pretrained-invoice-v1.1-2021-04-09 9 aprile 2024 Non applicabile
pretrained-invoice-v1.2-2022-02-18 18 febbraio 2022 Non applicabile
pretrained-invoice-v1.3-2022-07-15 15 luglio 2022 Non applicabile
Riassuntore Data di uscita Data di ritiro
pretrained-foundation-model-v1.0-2023-08-22 22 agosto 2023 Non applicabile
Enterprise Document OCR (riconoscimento ottico dei caratteri) Data di uscita Data di ritiro
pretrained-ocr-v1.2-2022-11-10 10 novembre 2022 Non applicabile
pretrained-ocr-v2.0-2023-06-02 2 giugno 2023 Non applicabile
pretrained-ocr-v2.1-2024-08-07 7 agosto 2024 Non applicabile

managing-processor-versions-3

Ciclo di vita della versione del processore

Non appena è disponibile una nuova versione di Google, devi creare e valutare nuove versioni utente con la nuova versione di base. Quindi, esegui il deployment della nuova versione e annulla il deployment (o elimina) le versioni utente precedenti che utilizzano la versione stabile precedente come base. Le versioni stabili vengono ritirate dopo il rilascio di una nuova. Google ti invia un preavviso di almeno sei mesi quando si verifica questa situazione.

Cosa succede quando una versione di base viene ritirata?

Le versioni utente che dipendono da versioni di base precedenti smettono di restituire previsioni quando la versione di base viene ritirata.

Come vengono selezionate le versioni del processore per le tue richieste?

Quando chiami un endpoint del processore senza specificare la versione del processore, viene utilizzata la versione predefinita. Quando la versione del processore predefinita cambia, potresti dover aggiornare il codice.

Endpoint utilizzato Esperienza
Se non specifichi un ID versione del processore Richieste elaborate utilizzando una nuova versione predefinita del processore.
Se la versione predefinita del processore è ritirata, l'impostazione predefinita viene aggiornata all'ultima versione stabile di Google lanciata quando la versione predefinita precedente viene ritirata.
Se specifichi l'ID versione del processore La risposta non va a buon fine se chiami un endpoint del processore e specifichi un ID versione ritirato.

Esempio di ritiro di una versione personalizzata

Considera lo scenario seguente che descrive la sequenza di eventi in un ritiro di una versione personalizzata:

  1. In qualità di sviluppatore, utilizzi un estrattore personalizzato per ottenere dati dai documenti. Data la complessità e il volume dei documenti che elabori, metti a punto il modello di base per creare una versione denominata fine-tune-A. Imposta la versione fine-tune-A come versione predefinita del processore e utilizzala per elaborare i documenti. La versione di base che alimenta il modello fine-tune-A è la versione stabile pretrained-foundation-model-v1.0-2023-08-22 (v1.0).

  2. Google ha pubblicato una nuova versione stabile denominata pretrained-foundation-model-v1.2-2024-05-10 (v1.2) e ha annunciato che la versione stabile v1.0 verrà ritirata il 9 aprile 2025.

  3. Poiché hai mantenuto i documenti di addestramento e test nel set di dati del processore, ottimizza un'altra versione in base alla versione stabile più recente di Google, v1.2, e chiamala fine-tune-B. Dopo averne valutato il rendimento, imposta la versione fine-tune-B come nuova versione predefinita del processore e ritira la versione fine-tune-A. La nuova versione ora utilizza l'ultima versione stabile di Google supportata.

D'altra parte, se non avessi creato e valutato la versione personalizzata di fine-tune-B, Google avrebbe aggiornato la versione predefinita del processore a v1.2 il 9 aprile 2025. Poiché stai chiamando l'endpoint del processore e non specificando una versione del processore, la nuova versione v1.2 viene utilizzata come nuova versione predefinita per elaborare le tue richieste.

Risorse per il ritiro e la migrazione

Per i parser e i processori ritirati, puoi consultare Ritiri di Document AI.

Consulta le seguenti risorse per le migrazioni:

Seleziona una versione del processore

Esistono tre modi per specificare la versione del processore da utilizzare per l'elaborazione batch e online:

  • Se non specifichi una versione, viene utilizzata quella predefinita del processore.

    • Esempio: projects/my-proj/locations/us/processors/my-processor:process
  • Se specifichi una versione, viene utilizzata quella specifica. Se la versione specifica non esiste, la richiesta non va a buon fine e viene visualizzato un errore.

    • Esempio: projects/my-proj/locations/us/processors/my-processor/processorVersions/pretrained-invoice-v1.2-2022-02-18:process
  • Se specifichi un canale, viene utilizzata l'ultima versione disponibile in quel canale. (Opzioni: stable, rc)

    • Esempio: projects/my-proj/locations/us/processors/my-processor/processorVersions/stable:process

Visualizza la versione disponibile

Console

  1. Nella Google Cloud console, nella sezione Document AI, vai alla pagina Processori.

    Vai a Processori

  2. Nell'elenco dei responsabili del trattamento, fai clic sul nome di quello di cui vuoi visualizzare i dettagli.

  3. Seleziona la scheda Gestisci versioni (o Esegui il deployment e utilizza), che mostrerà tutte le versioni del processore disponibili.

REST

Questo esempio mostra come elencare le versioni del processore disponibili per il tuo processore utilizzando il metodo processorVersions.list.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • LOCATION: la posizione del responsabile del trattamento, ad esempio:
    • us - Stati Uniti
    • eu - Unione Europea
  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • PROCESSOR_ID: l'ID del tuo processore personalizzato.

Metodo HTTP e URL:

GET https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions"

PowerShell

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions" | Select-Object -Expand Content

La risposta contiene un elenco di ProcessorVersions, che contiene informazioni su ogni versione del processore, come name, state e altri dettagli.

 {   "processorVersions": [     {       "name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained-ocr-v1.1-2022-09-12",       "displayName": "Google Release Candidate",       "state": "DEPLOYED",       "createTime": "2022-09-13T23:39:12.156648Z",       "googleManaged": true     },     {       "name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained-ocr-v1.0-2020-09-23",       "displayName": "Google Stable",       "state": "DEPLOYED",       "createTime": "2022-09-12T23:35:09.829557Z",       "googleManaged": true,       "deprecationInfo": {         "deprecationTime": "1970-01-01T00:00:00Z"       }     }   ] } 

C#

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per C#.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

using Google.Api.Gax; using Google.Cloud.DocumentAI.V1; using System;  public sealed partial class GeneratedDocumentProcessorServiceClientSnippets {     /// <summary>Snippet for ListProcessorVersions</summary>     /// <remarks>     /// This snippet has been automatically generated and should be regarded as a code template only.     /// It will require modifications to work:     /// - It may require correct/in-range values for request initialization.     /// - It may require specifying regional endpoints when creating the service client as shown in     ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.     /// </remarks>     public void ListProcessorVersionsRequestObject()     {         // Create client         DocumentProcessorServiceClient documentProcessorServiceClient = DocumentProcessorServiceClient.Create();         // Initialize request argument(s)         ListProcessorVersionsRequest request = new ListProcessorVersionsRequest         {             ParentAsProcessorName = ProcessorName.FromProjectLocationProcessor("[PROJECT]", "[LOCATION]", "[PROCESSOR]"),         };         // Make the request         PagedEnumerable<ListProcessorVersionsResponse, ProcessorVersion> response = documentProcessorServiceClient.ListProcessorVersions(request);          // Iterate over all response items, lazily performing RPCs as required         foreach (ProcessorVersion item in response)         {             // Do something with each item             Console.WriteLine(item);         }          // Or iterate over pages (of server-defined size), performing one RPC per page         foreach (ListProcessorVersionsResponse page in response.AsRawResponses())         {             // Do something with each page of items             Console.WriteLine("A page of results:");             foreach (ProcessorVersion item in page)             {                 // Do something with each item                 Console.WriteLine(item);             }         }          // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required         int pageSize = 10;         Page<ProcessorVersion> singlePage = response.ReadPage(pageSize);         // Do something with the page of items         Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");         foreach (ProcessorVersion item in singlePage)         {             // Do something with each item             Console.WriteLine(item);         }         // Store the pageToken, for when the next page is required.         string nextPageToken = singlePage.NextPageToken;     } }

Go

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Go.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 package main  import ( 	"context"  	documentai "cloud.google.com/go/documentai/apiv1" 	documentaipb "cloud.google.com/go/documentai/apiv1/documentaipb" 	"google.golang.org/api/iterator" )  func main() { 	ctx := context.Background() 	// This snippet has been automatically generated and should be regarded as a code template only. 	// It will require modifications to work: 	// - It may require correct/in-range values for request initialization. 	// - It may require specifying regional endpoints when creating the service client as shown in: 	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options 	c, err := documentai.NewDocumentProcessorClient(ctx) 	if err != nil { 		// TODO: Handle error. 	} 	defer c.Close()  	req := &documentaipb.ListProcessorVersionsRequest{ 		// TODO: Fill request struct fields. 		// See https://pkg.go.dev/cloud.google.com/go/documentai/apiv1/documentaipb#ListProcessorVersionsRequest. 	} 	it := c.ListProcessorVersions(ctx, req) 	for { 		resp, err := it.Next() 		if err == iterator.Done { 			break 		} 		if err != nil { 			// TODO: Handle error. 		} 		// TODO: Use resp. 		_ = resp  		// If you need to access the underlying RPC response, 		// you can do so by casting the `Response` as below. 		// Otherwise, remove this line. Only populated after 		// first call to Next(). Not safe for concurrent access. 		_ = it.Response.(*documentaipb.ListProcessorVersionsResponse) 	} } 

Java

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Java.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

import com.google.cloud.documentai.v1.DocumentProcessorServiceClient; import com.google.cloud.documentai.v1.ListProcessorVersionsRequest; import com.google.cloud.documentai.v1.ProcessorName; import com.google.cloud.documentai.v1.ProcessorVersion;  public class SyncListProcessorVersions {    public static void main(String[] args) throws Exception {     syncListProcessorVersions();   }    public static void syncListProcessorVersions() throws Exception {     // This snippet has been automatically generated and should be regarded as a code template only.     // It will require modifications to work:     // - It may require correct/in-range values for request initialization.     // - It may require specifying regional endpoints when creating the service client as shown in     // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library     try (DocumentProcessorServiceClient documentProcessorServiceClient =         DocumentProcessorServiceClient.create()) {       ListProcessorVersionsRequest request =           ListProcessorVersionsRequest.newBuilder()               .setParent(ProcessorName.of("[PROJECT]", "[LOCATION]", "[PROCESSOR]").toString())               .setPageSize(883849137)               .setPageToken("pageToken873572522")               .build();       for (ProcessorVersion element :           documentProcessorServiceClient.listProcessorVersions(request).iterateAll()) {         // doThingsWith(element);       }     }   } }

Python

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Python.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 from google.api_core.client_options import ClientOptions from google.cloud import documentai  # type: ignore  # TODO(developer): Uncomment these variables before running the sample. # project_id = 'YOUR_PROJECT_ID' # location = 'YOUR_PROCESSOR_LOCATION' # Format is 'us' or 'eu' # processor_id = 'YOUR_PROCESSOR_ID' # Create processor before running sample   def list_processor_versions_sample(     project_id: str, location: str, processor_id: str ) -> None:     # You must set the `api_endpoint` if you use a location other than "us".     opts = ClientOptions(api_endpoint=f"{location}-documentai.googleapis.com")      client = documentai.DocumentProcessorServiceClient(client_options=opts)      # The full resource name of the processor     # e.g.: projects/project_id/locations/location/processors/processor_id     parent = client.processor_path(project_id, location, processor_id)      # Make ListProcessorVersions request     processor_versions = client.list_processor_versions(parent=parent)      # Print the processor version information     for processor_version in processor_versions:         processor_version_id = client.parse_processor_version_path(             processor_version.name         )["processor_version"]          print(f"Processor Version: {processor_version_id}")         print(f"Display Name: {processor_version.display_name}")         print(f"DEPLOYED: {processor_version.state}")         print("")  

Ruby

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Ruby.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

require "google/cloud/document_ai/v1"  ## # Snippet for the list_processor_versions call in the DocumentProcessorService service # # This snippet has been automatically generated and should be regarded as a code # template only. It will require modifications to work: # - It may require correct/in-range values for request initialization. # - It may require specifying regional endpoints when creating the service # client as shown in https://cloud.google.com/ruby/docs/reference. # # This is an auto-generated example demonstrating basic usage of # Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client#list_processor_versions. # def list_processor_versions   # Create a client object. The client can be reused for multiple calls.   client = Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client.new    # Create a request. To set request fields, pass in keyword arguments.   request = Google::Cloud::DocumentAI::V1::ListProcessorVersionsRequest.new    # Call the list_processor_versions method.   result = client.list_processor_versions request    # The returned object is of type Gapic::PagedEnumerable. You can iterate   # over elements, and API calls will be issued to fetch pages as needed.   result.each do |item|     # Each element is of type ::Google::Cloud::DocumentAI::V1::ProcessorVersion.     p item   end end

Visualizzare i dettagli di una versione

Console

  1. Nella Google Cloud console, nella sezione Document AI, vai alla pagina Processori.

    Vai a Processori

  2. Nell'elenco dei responsabili del trattamento, fai clic sul nome di quello di cui vuoi visualizzare i dettagli.

  3. Seleziona la scheda Gestisci versioni (o Esegui il deployment e utilizza), che mostrerà tutte le versioni del processore disponibili e i relativi dettagli.

REST

Questo esempio mostra come ottenere i dettagli di una versione del processore per il tuo processore utilizzando il metodo processorVersions.get.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • LOCATION: la posizione del responsabile del trattamento, ad esempio:
    • us - Stati Uniti
    • eu - Unione Europea
  • PROJECT_ID: il tuo 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-DD
    • stable
    • rc

Metodo HTTP e URL:

GET https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"

PowerShell

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION" | Select-Object -Expand Content

La risposta è un ProcessorVersion, che contiene informazioni sulla versione del processore, come name, state e altri dettagli.

 {   "name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained-ocr-v1.1-2022-09-12",   "displayName": "Google Release Candidate",   "state": "DEPLOYED",   "createTime": "2022-09-13T23:39:12.156648Z",   "googleManaged": true } 

C#

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per C#.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

using Google.Cloud.DocumentAI.V1;  public sealed partial class GeneratedDocumentProcessorServiceClientSnippets {     /// <summary>Snippet for GetProcessorVersion</summary>     /// <remarks>     /// This snippet has been automatically generated and should be regarded as a code template only.     /// It will require modifications to work:     /// - It may require correct/in-range values for request initialization.     /// - It may require specifying regional endpoints when creating the service client as shown in     ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.     /// </remarks>     public void GetProcessorVersionRequestObject()     {         // Create client         DocumentProcessorServiceClient documentProcessorServiceClient = DocumentProcessorServiceClient.Create();         // Initialize request argument(s)         GetProcessorVersionRequest request = new GetProcessorVersionRequest         {             ProcessorVersionName = ProcessorVersionName.FromProjectLocationProcessorProcessorVersion("[PROJECT]", "[LOCATION]", "[PROCESSOR]", "[PROCESSOR_VERSION]"),         };         // Make the request         ProcessorVersion response = documentProcessorServiceClient.GetProcessorVersion(request);     } }

Go

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Go.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 package main  import ( 	"context"  	documentai "cloud.google.com/go/documentai/apiv1" 	documentaipb "cloud.google.com/go/documentai/apiv1/documentaipb" )  func main() { 	ctx := context.Background() 	// This snippet has been automatically generated and should be regarded as a code template only. 	// It will require modifications to work: 	// - It may require correct/in-range values for request initialization. 	// - It may require specifying regional endpoints when creating the service client as shown in: 	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options 	c, err := documentai.NewDocumentProcessorClient(ctx) 	if err != nil { 		// TODO: Handle error. 	} 	defer c.Close()  	req := &documentaipb.GetProcessorVersionRequest{ 		// TODO: Fill request struct fields. 		// See https://pkg.go.dev/cloud.google.com/go/documentai/apiv1/documentaipb#GetProcessorVersionRequest. 	} 	resp, err := c.GetProcessorVersion(ctx, req) 	if err != nil { 		// TODO: Handle error. 	} 	// TODO: Use resp. 	_ = resp } 

Java

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Java.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

import com.google.cloud.documentai.v1.DocumentProcessorServiceClient; import com.google.cloud.documentai.v1.GetProcessorVersionRequest; import com.google.cloud.documentai.v1.ProcessorVersion; import com.google.cloud.documentai.v1.ProcessorVersionName;  public class SyncGetProcessorVersion {    public static void main(String[] args) throws Exception {     syncGetProcessorVersion();   }    public static void syncGetProcessorVersion() throws Exception {     // This snippet has been automatically generated and should be regarded as a code template only.     // It will require modifications to work:     // - It may require correct/in-range values for request initialization.     // - It may require specifying regional endpoints when creating the service client as shown in     // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library     try (DocumentProcessorServiceClient documentProcessorServiceClient =         DocumentProcessorServiceClient.create()) {       GetProcessorVersionRequest request =           GetProcessorVersionRequest.newBuilder()               .setName(                   ProcessorVersionName.of(                           "[PROJECT]", "[LOCATION]", "[PROCESSOR]", "[PROCESSOR_VERSION]")                       .toString())               .build();       ProcessorVersion response = documentProcessorServiceClient.getProcessorVersion(request);     }   } }

Python

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Python.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 from google.api_core.client_options import ClientOptions from google.cloud import documentai  # type: ignore  # TODO(developer): Uncomment these variables before running the sample. # project_id = 'YOUR_PROJECT_ID' # location = 'YOUR_PROCESSOR_LOCATION' # Format is 'us' or 'eu' # processor_id = 'YOUR_PROCESSOR_ID' # Create processor before running sample # processor_version_id = 'YOUR_PROCESSOR_VERSION_ID'   def get_processor_version_sample(     project_id: str, location: str, processor_id: str, processor_version_id: str ) -> None:     # You must set the api_endpoint if you use a location other than 'us'.     opts = ClientOptions(api_endpoint=f"{location}-documentai.googleapis.com")      client = documentai.DocumentProcessorServiceClient(client_options=opts)      # The full resource name of the processor version     # e.g.: projects/project_id/locations/location/processors/processor_id/processorVersions/processor_version_id     name = client.processor_version_path(         project_id, location, processor_id, processor_version_id     )      # Make GetProcessorVersion request     processor_version = client.get_processor_version(name=name)      # Print the processor version information     print(f"Processor Version: {processor_version_id}")     print(f"Display Name: {processor_version.display_name}")     print(f"DEPLOYED: {processor_version.state}")  

Ruby

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Ruby.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

require "google/cloud/document_ai/v1"  ## # Snippet for the get_processor_version call in the DocumentProcessorService service # # This snippet has been automatically generated and should be regarded as a code # template only. It will require modifications to work: # - It may require correct/in-range values for request initialization. # - It may require specifying regional endpoints when creating the service # client as shown in https://cloud.google.com/ruby/docs/reference. # # This is an auto-generated example demonstrating basic usage of # Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client#get_processor_version. # def get_processor_version   # Create a client object. The client can be reused for multiple calls.   client = Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client.new    # Create a request. To set request fields, pass in keyword arguments.   request = Google::Cloud::DocumentAI::V1::GetProcessorVersionRequest.new    # Call the get_processor_version method.   result = client.get_processor_version request    # The returned object is of type Google::Cloud::DocumentAI::V1::ProcessorVersion.   p result end

Modificare la versione predefinita

La versione predefinita di un processore specifica la versione utilizzata per elaborare i documenti quando non ne specifichi una in particolare. Quando crei un processore, la versione predefinita iniziale è l'ultima versione del canale stabile.

Se modifichi la versione predefinita, le richieste in entrata vengono elaborate utilizzando la versione appena selezionata. Se modifichi la versione predefinita mentre il processore è in corso di elaborazione di una richiesta, la richiesta continuerà a utilizzare la versione selezionata in precedenza.

Per cambiare la versione predefinita:

Console

  1. Nella Google Cloud console, nella sezione Document AI, vai alla pagina Processori.

    Vai alla pagina Processori

  2. Nell'elenco dei responsabili del trattamento, fai clic sul nome di quello di cui vuoi visualizzare i dettagli.

  3. Nella scheda Gestisci versioni (o Implementa e utilizza) del processore, scegli una versione del processore da utilizzare come versione predefinita dal menu a discesa Versione predefinita.

REST

Questo esempio mostra come impostare la versione predefinita del processore per il processore utilizzando il metodo processors.setDefaultProcessorVersion.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • LOCATION: la posizione del responsabile del trattamento, ad esempio:
    • us - Stati Uniti
    • eu - Unione Europea
  • PROJECT_ID: il tuo 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-DD
    • stable
    • rc

Metodo HTTP e URL:

POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID:setDefaultProcessorVersion

Corpo JSON della richiesta:

 {   "defaultProcessorVersion": "PROCESSOR_VERSION" } 

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, ed esegui questo comando:

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:setDefaultProcessorVersion"

PowerShell

Salva il corpo della richiesta in un file denominato request.json, ed esegui questo comando:

$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:setDefaultProcessorVersion" | Select-Object -Expand Content

La risposta è un'operazione a lunga esecuzione. Per eseguire il polling dell'operazione a lunga esecuzione, chiama operations.get

SetDefaultProcessorVersionMetadata nella risposta indica lo stato dell'operazione.

 {   "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",   "metadata": {     "@type": "type.googleapis.com/google.cloud.documentai.v1.SetDefaultProcessorVersionMetadata",     "commonMetadata": {       "state": "SUCCEEDED",       "createTime": "2022-03-02T22:52:49.957096Z",       "updateTime": "2022-03-02T22:52:50.175976Z",       "resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"     }   },   "done": true,   "response": {     "@type": "type.googleapis.com/google.cloud.documentai.v1.SetDefaultProcessorVersionResponse"   } } 

C#

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per C#.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

using Google.Cloud.DocumentAI.V1; using Google.LongRunning;  public sealed partial class GeneratedDocumentProcessorServiceClientSnippets {     /// <summary>Snippet for SetDefaultProcessorVersion</summary>     /// <remarks>     /// This snippet has been automatically generated and should be regarded as a code template only.     /// It will require modifications to work:     /// - It may require correct/in-range values for request initialization.     /// - It may require specifying regional endpoints when creating the service client as shown in     ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.     /// </remarks>     public void SetDefaultProcessorVersionRequestObject()     {         // Create client         DocumentProcessorServiceClient documentProcessorServiceClient = DocumentProcessorServiceClient.Create();         // Initialize request argument(s)         SetDefaultProcessorVersionRequest request = new SetDefaultProcessorVersionRequest         {             ProcessorAsProcessorName = ProcessorName.FromProjectLocationProcessor("[PROJECT]", "[LOCATION]", "[PROCESSOR]"),             DefaultProcessorVersionAsProcessorVersionName = ProcessorVersionName.FromProjectLocationProcessorProcessorVersion("[PROJECT]", "[LOCATION]", "[PROCESSOR]", "[PROCESSOR_VERSION]"),         };         // Make the request         Operation<SetDefaultProcessorVersionResponse, SetDefaultProcessorVersionMetadata> response = documentProcessorServiceClient.SetDefaultProcessorVersion(request);          // Poll until the returned long-running operation is complete         Operation<SetDefaultProcessorVersionResponse, SetDefaultProcessorVersionMetadata> completedResponse = response.PollUntilCompleted();         // Retrieve the operation result         SetDefaultProcessorVersionResponse result = completedResponse.Result;          // Or get the name of the operation         string operationName = response.Name;         // This name can be stored, then the long-running operation retrieved later by name         Operation<SetDefaultProcessorVersionResponse, SetDefaultProcessorVersionMetadata> retrievedResponse = documentProcessorServiceClient.PollOnceSetDefaultProcessorVersion(operationName);         // Check if the retrieved long-running operation has completed         if (retrievedResponse.IsCompleted)         {             // If it has completed, then access the result             SetDefaultProcessorVersionResponse retrievedResult = retrievedResponse.Result;         }     } }

Go

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Go.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 package main  import ( 	"context"  	documentai "cloud.google.com/go/documentai/apiv1" 	documentaipb "cloud.google.com/go/documentai/apiv1/documentaipb" )  func main() { 	ctx := context.Background() 	// This snippet has been automatically generated and should be regarded as a code template only. 	// It will require modifications to work: 	// - It may require correct/in-range values for request initialization. 	// - It may require specifying regional endpoints when creating the service client as shown in: 	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options 	c, err := documentai.NewDocumentProcessorClient(ctx) 	if err != nil { 		// TODO: Handle error. 	} 	defer c.Close()  	req := &documentaipb.SetDefaultProcessorVersionRequest{ 		// TODO: Fill request struct fields. 		// See https://pkg.go.dev/cloud.google.com/go/documentai/apiv1/documentaipb#SetDefaultProcessorVersionRequest. 	} 	op, err := c.SetDefaultProcessorVersion(ctx, req) 	if err != nil { 		// TODO: Handle error. 	}  	resp, err := op.Wait(ctx) 	if err != nil { 		// TODO: Handle error. 	} 	// TODO: Use resp. 	_ = resp } 

Java

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Java.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

import com.google.cloud.documentai.v1.DocumentProcessorServiceClient; import com.google.cloud.documentai.v1.ProcessorName; import com.google.cloud.documentai.v1.ProcessorVersionName; import com.google.cloud.documentai.v1.SetDefaultProcessorVersionRequest; import com.google.cloud.documentai.v1.SetDefaultProcessorVersionResponse;  public class SyncSetDefaultProcessorVersion {    public static void main(String[] args) throws Exception {     syncSetDefaultProcessorVersion();   }    public static void syncSetDefaultProcessorVersion() throws Exception {     // This snippet has been automatically generated and should be regarded as a code template only.     // It will require modifications to work:     // - It may require correct/in-range values for request initialization.     // - It may require specifying regional endpoints when creating the service client as shown in     // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library     try (DocumentProcessorServiceClient documentProcessorServiceClient =         DocumentProcessorServiceClient.create()) {       SetDefaultProcessorVersionRequest request =           SetDefaultProcessorVersionRequest.newBuilder()               .setProcessor(ProcessorName.of("[PROJECT]", "[LOCATION]", "[PROCESSOR]").toString())               .setDefaultProcessorVersion(                   ProcessorVersionName.of(                           "[PROJECT]", "[LOCATION]", "[PROCESSOR]", "[PROCESSOR_VERSION]")                       .toString())               .build();       SetDefaultProcessorVersionResponse response =           documentProcessorServiceClient.setDefaultProcessorVersionAsync(request).get();     }   } }

Python

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Python.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 from google.api_core.client_options import ClientOptions from google.api_core.exceptions import NotFound from google.cloud import documentai  # type: ignore  # TODO(developer): Uncomment these variables before running the sample. # project_id = 'YOUR_PROJECT_ID' # location = 'YOUR_PROCESSOR_LOCATION' # Format is 'us' or 'eu' # processor_id = 'YOUR_PROCESSOR_ID' # Create processor before running sample # processor_version_id = 'YOUR_PROCESSOR_VERSION_ID'   def set_default_processor_version_sample(     project_id: str, location: str, processor_id: str, processor_version_id: str ) -> None:     # You must set the api_endpoint if you use a location other than 'us'.     opts = ClientOptions(api_endpoint=f"{location}-documentai.googleapis.com")      client = documentai.DocumentProcessorServiceClient(client_options=opts)      # The full resource name of the processor     # e.g.: projects/project_id/locations/location/processors/processor_id     processor = client.processor_path(project_id, location, processor_id)      # The full resource name of the processor version     # e.g.: projects/project_id/locations/location/processors/processor_id/processorVersions/processor_version_id     processor_version = client.processor_version_path(         project_id, location, processor_id, processor_version_id     )      request = documentai.SetDefaultProcessorVersionRequest(         processor=processor, default_processor_version=processor_version     )      # Make SetDefaultProcessorVersion request     try:         operation = client.set_default_processor_version(request)         # Print operation details         print(operation.operation.name)         # Wait for operation to complete         operation.result()     except NotFound as e:         print(e.message)  

Ruby

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Ruby.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

require "google/cloud/document_ai/v1"  ## # Snippet for the set_default_processor_version call in the DocumentProcessorService service # # This snippet has been automatically generated and should be regarded as a code # template only. It will require modifications to work: # - It may require correct/in-range values for request initialization. # - It may require specifying regional endpoints when creating the service # client as shown in https://cloud.google.com/ruby/docs/reference. # # This is an auto-generated example demonstrating basic usage of # Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client#set_default_processor_version. # def set_default_processor_version   # Create a client object. The client can be reused for multiple calls.   client = Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client.new    # Create a request. To set request fields, pass in keyword arguments.   request = Google::Cloud::DocumentAI::V1::SetDefaultProcessorVersionRequest.new    # Call the set_default_processor_version method.   result = client.set_default_processor_version request    # The returned object is of type Gapic::Operation. You can use it to   # check the status of an operation, cancel it, or wait for results.   # Here is how to wait for a response.   result.wait_until_done! timeout: 60   if result.response?     p result.response   else     puts "No response received."   end end

Esegui il deployment di una versione del processore

Dopo aver creato una nuova versione del processore con Document AI, dovrai eseguirne il deployment prima di poter elaborare i documenti con questa versione.

Console

  1. Nella Google Cloud console, nella sezione Document AI, vai alla pagina Processori.

    Vai alla pagina Processori

  2. Nell'elenco dei responsabili del trattamento, fai clic sul nome di quello di cui vuoi visualizzare i dettagli.

  3. Nella scheda Gestisci versioni (o Esegui il deployment e utilizza) del processore, seleziona la casella di controllo accanto alla versione del processore di cui vuoi eseguire il deployment.

  4. Fai clic su Esegui il deployment, quindi di nuovo su Esegui il deployment nella finestra di dialogo. Questa operazione richiede alcuni minuti.

REST

Questo esempio mostra come eseguire il deployment di una versione del processore per il tuo processore utilizzando il metodo processorVersions.deploy.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • LOCATION: la posizione del responsabile del trattamento, ad esempio:
    • us - Stati Uniti
    • eu - Unione Europea
  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • PROCESSOR_ID: l'ID del tuo processore personalizzato.
  • PROCESSOR_VERSION: l'identificatore della versione del processore.

Metodo HTTP e URL:

POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:deploy

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:deploy"

PowerShell

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:deploy" | Select-Object -Expand Content

La risposta è un'operazione a lunga esecuzione. Per eseguire il polling dell'operazione a lunga esecuzione, chiama operations.get

DeployProcessorVersionMetadata nella risposta indica lo stato dell'operazione.

 {   "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",   "metadata": {     "@type": "type.googleapis.com/google.cloud.documentai.v1.DeployProcessorVersionMetadata",     "commonMetadata": {       "state": "SUCCEEDED",       "createTime": "2022-08-29T16:27:00.195539Z",       "updateTime": "2022-08-29T16:32:01.963962Z",       "resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"     }   },   "done": true,   "response": {     "@type": "type.googleapis.com/google.cloud.documentai.v1.DeployProcessorVersionResponse"   } } 

C#

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per C#.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

using Google.Cloud.DocumentAI.V1; using Google.LongRunning;  public sealed partial class GeneratedDocumentProcessorServiceClientSnippets {     /// <summary>Snippet for DeployProcessorVersion</summary>     /// <remarks>     /// This snippet has been automatically generated and should be regarded as a code template only.     /// It will require modifications to work:     /// - It may require correct/in-range values for request initialization.     /// - It may require specifying regional endpoints when creating the service client as shown in     ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.     /// </remarks>     public void DeployProcessorVersionRequestObject()     {         // Create client         DocumentProcessorServiceClient documentProcessorServiceClient = DocumentProcessorServiceClient.Create();         // Initialize request argument(s)         DeployProcessorVersionRequest request = new DeployProcessorVersionRequest         {             ProcessorVersionName = ProcessorVersionName.FromProjectLocationProcessorProcessorVersion("[PROJECT]", "[LOCATION]", "[PROCESSOR]", "[PROCESSOR_VERSION]"),         };         // Make the request         Operation<DeployProcessorVersionResponse, DeployProcessorVersionMetadata> response = documentProcessorServiceClient.DeployProcessorVersion(request);          // Poll until the returned long-running operation is complete         Operation<DeployProcessorVersionResponse, DeployProcessorVersionMetadata> completedResponse = response.PollUntilCompleted();         // Retrieve the operation result         DeployProcessorVersionResponse result = completedResponse.Result;          // Or get the name of the operation         string operationName = response.Name;         // This name can be stored, then the long-running operation retrieved later by name         Operation<DeployProcessorVersionResponse, DeployProcessorVersionMetadata> retrievedResponse = documentProcessorServiceClient.PollOnceDeployProcessorVersion(operationName);         // Check if the retrieved long-running operation has completed         if (retrievedResponse.IsCompleted)         {             // If it has completed, then access the result             DeployProcessorVersionResponse retrievedResult = retrievedResponse.Result;         }     } }

Go

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Go.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 package main  import ( 	"context"  	documentai "cloud.google.com/go/documentai/apiv1" 	documentaipb "cloud.google.com/go/documentai/apiv1/documentaipb" )  func main() { 	ctx := context.Background() 	// This snippet has been automatically generated and should be regarded as a code template only. 	// It will require modifications to work: 	// - It may require correct/in-range values for request initialization. 	// - It may require specifying regional endpoints when creating the service client as shown in: 	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options 	c, err := documentai.NewDocumentProcessorClient(ctx) 	if err != nil { 		// TODO: Handle error. 	} 	defer c.Close()  	req := &documentaipb.DeployProcessorVersionRequest{ 		// TODO: Fill request struct fields. 		// See https://pkg.go.dev/cloud.google.com/go/documentai/apiv1/documentaipb#DeployProcessorVersionRequest. 	} 	op, err := c.DeployProcessorVersion(ctx, req) 	if err != nil { 		// TODO: Handle error. 	}  	resp, err := op.Wait(ctx) 	if err != nil { 		// TODO: Handle error. 	} 	// TODO: Use resp. 	_ = resp } 

Java

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Java.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

import com.google.cloud.documentai.v1.DeployProcessorVersionRequest; import com.google.cloud.documentai.v1.DeployProcessorVersionResponse; import com.google.cloud.documentai.v1.DocumentProcessorServiceClient; import com.google.cloud.documentai.v1.ProcessorVersionName;  public class SyncDeployProcessorVersion {    public static void main(String[] args) throws Exception {     syncDeployProcessorVersion();   }    public static void syncDeployProcessorVersion() throws Exception {     // This snippet has been automatically generated and should be regarded as a code template only.     // It will require modifications to work:     // - It may require correct/in-range values for request initialization.     // - It may require specifying regional endpoints when creating the service client as shown in     // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library     try (DocumentProcessorServiceClient documentProcessorServiceClient =         DocumentProcessorServiceClient.create()) {       DeployProcessorVersionRequest request =           DeployProcessorVersionRequest.newBuilder()               .setName(                   ProcessorVersionName.of(                           "[PROJECT]", "[LOCATION]", "[PROCESSOR]", "[PROCESSOR_VERSION]")                       .toString())               .build();       DeployProcessorVersionResponse response =           documentProcessorServiceClient.deployProcessorVersionAsync(request).get();     }   } }

Python

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Python.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 from google.api_core.client_options import ClientOptions from google.api_core.exceptions import FailedPrecondition from google.cloud import documentai  # type: ignore  # TODO(developer): Uncomment these variables before running the sample. # project_id = 'YOUR_PROJECT_ID' # location = 'YOUR_PROCESSOR_LOCATION' # Format is 'us' or 'eu' # processor_id = 'YOUR_PROCESSOR_ID' # processor_version_id = 'YOUR_PROCESSOR_VERSION_ID'   def deploy_processor_version_sample(     project_id: str, location: str, processor_id: str, processor_version_id: str ) -> None:     # You must set the api_endpoint if you use a location other than 'us'.     opts = ClientOptions(api_endpoint=f"{location}-documentai.googleapis.com")      client = documentai.DocumentProcessorServiceClient(client_options=opts)      # The full resource name of the processor version     # e.g.: projects/project_id/locations/location/processors/processor_id/processorVersions/processor_version_id     name = client.processor_version_path(         project_id, location, processor_id, processor_version_id     )      # Make DeployProcessorVersion request     try:         operation = client.deploy_processor_version(name=name)         # Print operation details         print(operation.operation.name)         # Wait for operation to complete         operation.result()     # Deploy request will fail if the     # processor version is already deployed     except FailedPrecondition as e:         print(e.message)  

Ruby

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Ruby.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

require "google/cloud/document_ai/v1"  ## # Snippet for the deploy_processor_version call in the DocumentProcessorService service # # This snippet has been automatically generated and should be regarded as a code # template only. It will require modifications to work: # - It may require correct/in-range values for request initialization. # - It may require specifying regional endpoints when creating the service # client as shown in https://cloud.google.com/ruby/docs/reference. # # This is an auto-generated example demonstrating basic usage of # Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client#deploy_processor_version. # def deploy_processor_version   # Create a client object. The client can be reused for multiple calls.   client = Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client.new    # Create a request. To set request fields, pass in keyword arguments.   request = Google::Cloud::DocumentAI::V1::DeployProcessorVersionRequest.new    # Call the deploy_processor_version method.   result = client.deploy_processor_version request    # The returned object is of type Gapic::Operation. You can use it to   # check the status of an operation, cancel it, or wait for results.   # Here is how to wait for a response.   result.wait_until_done! timeout: 60   if result.response?     p result.response   else     puts "No response received."   end end

Annullare il deployment di una versione del processore

Dopo aver creato una nuova versione del processore con Document AI e averne eseguito il deployment, puoi annullarlo se non vuoi che la versione del processore sia in grado di gestire le richieste di elaborazione.

Console

  1. Nella Google Cloud console, nella sezione Document AI, vai alla pagina Processori.

    Vai alla pagina Processori

  2. Nell'elenco dei responsabili del trattamento, fai clic sul nome di quello di cui vuoi visualizzare i dettagli.

  3. Nella scheda Gestisci versioni (o Esegui il deployment e utilizza) del processore, seleziona la casella di controllo accanto alla versione del processore di cui vuoi annullare il deployment.

  4. Fai clic su Annulla deployment, quindi di nuovo su Annulla deployment nella finestra di dialogo. Questa procedura richiede alcuni minuti.

REST

Questo esempio mostra come annullare il deployment di una versione del processore per il processore utilizzando il metodo processorVersions.undeploy.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • LOCATION: la posizione del responsabile del trattamento, ad esempio:
    • us - Stati Uniti
    • eu - Unione Europea
  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • PROCESSOR_ID: l'ID del tuo processore personalizzato.
  • PROCESSOR_VERSION: l'identificatore della versione del processore.

Metodo HTTP e URL:

POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:undeploy

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:undeploy"

PowerShell

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION:undeploy" | Select-Object -Expand Content

La risposta è un'operazione a lunga esecuzione. Per eseguire il polling dell'operazione a lunga esecuzione, chiama operations.get

UndeployProcessorVersionMetadata nella risposta indica lo stato dell'operazione.

 {   "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",   "metadata": {     "@type": "type.googleapis.com/google.cloud.documentai.v1.UndeployProcessorVersionMetadata",     "commonMetadata": {       "state": "SUCCEEDED",       "createTime": "2022-08-29T16:27:00.195539Z",       "updateTime": "2022-08-29T16:32:01.963962Z",       "resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"     }   },   "done": true,   "response": {     "@type": "type.googleapis.com/google.cloud.documentai.v1.UndeployProcessorVersionResponse"   } } 

C#

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per C#.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

using Google.Cloud.DocumentAI.V1; using Google.LongRunning;  public sealed partial class GeneratedDocumentProcessorServiceClientSnippets {     /// <summary>Snippet for UndeployProcessorVersion</summary>     /// <remarks>     /// This snippet has been automatically generated and should be regarded as a code template only.     /// It will require modifications to work:     /// - It may require correct/in-range values for request initialization.     /// - It may require specifying regional endpoints when creating the service client as shown in     ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.     /// </remarks>     public void UndeployProcessorVersionRequestObject()     {         // Create client         DocumentProcessorServiceClient documentProcessorServiceClient = DocumentProcessorServiceClient.Create();         // Initialize request argument(s)         UndeployProcessorVersionRequest request = new UndeployProcessorVersionRequest         {             ProcessorVersionName = ProcessorVersionName.FromProjectLocationProcessorProcessorVersion("[PROJECT]", "[LOCATION]", "[PROCESSOR]", "[PROCESSOR_VERSION]"),         };         // Make the request         Operation<UndeployProcessorVersionResponse, UndeployProcessorVersionMetadata> response = documentProcessorServiceClient.UndeployProcessorVersion(request);          // Poll until the returned long-running operation is complete         Operation<UndeployProcessorVersionResponse, UndeployProcessorVersionMetadata> completedResponse = response.PollUntilCompleted();         // Retrieve the operation result         UndeployProcessorVersionResponse result = completedResponse.Result;          // Or get the name of the operation         string operationName = response.Name;         // This name can be stored, then the long-running operation retrieved later by name         Operation<UndeployProcessorVersionResponse, UndeployProcessorVersionMetadata> retrievedResponse = documentProcessorServiceClient.PollOnceUndeployProcessorVersion(operationName);         // Check if the retrieved long-running operation has completed         if (retrievedResponse.IsCompleted)         {             // If it has completed, then access the result             UndeployProcessorVersionResponse retrievedResult = retrievedResponse.Result;         }     } }

Go

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Go.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 package main  import ( 	"context"  	documentai "cloud.google.com/go/documentai/apiv1" 	documentaipb "cloud.google.com/go/documentai/apiv1/documentaipb" )  func main() { 	ctx := context.Background() 	// This snippet has been automatically generated and should be regarded as a code template only. 	// It will require modifications to work: 	// - It may require correct/in-range values for request initialization. 	// - It may require specifying regional endpoints when creating the service client as shown in: 	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options 	c, err := documentai.NewDocumentProcessorClient(ctx) 	if err != nil { 		// TODO: Handle error. 	} 	defer c.Close()  	req := &documentaipb.UndeployProcessorVersionRequest{ 		// TODO: Fill request struct fields. 		// See https://pkg.go.dev/cloud.google.com/go/documentai/apiv1/documentaipb#UndeployProcessorVersionRequest. 	} 	op, err := c.UndeployProcessorVersion(ctx, req) 	if err != nil { 		// TODO: Handle error. 	}  	resp, err := op.Wait(ctx) 	if err != nil { 		// TODO: Handle error. 	} 	// TODO: Use resp. 	_ = resp } 

Java

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Java.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

import com.google.cloud.documentai.v1.DocumentProcessorServiceClient; import com.google.cloud.documentai.v1.ProcessorVersionName; import com.google.cloud.documentai.v1.UndeployProcessorVersionRequest; import com.google.cloud.documentai.v1.UndeployProcessorVersionResponse;  public class SyncUndeployProcessorVersion {    public static void main(String[] args) throws Exception {     syncUndeployProcessorVersion();   }    public static void syncUndeployProcessorVersion() throws Exception {     // This snippet has been automatically generated and should be regarded as a code template only.     // It will require modifications to work:     // - It may require correct/in-range values for request initialization.     // - It may require specifying regional endpoints when creating the service client as shown in     // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library     try (DocumentProcessorServiceClient documentProcessorServiceClient =         DocumentProcessorServiceClient.create()) {       UndeployProcessorVersionRequest request =           UndeployProcessorVersionRequest.newBuilder()               .setName(                   ProcessorVersionName.of(                           "[PROJECT]", "[LOCATION]", "[PROCESSOR]", "[PROCESSOR_VERSION]")                       .toString())               .build();       UndeployProcessorVersionResponse response =           documentProcessorServiceClient.undeployProcessorVersionAsync(request).get();     }   } }

Python

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Python.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 from google.api_core.client_options import ClientOptions from google.api_core.exceptions import FailedPrecondition from google.api_core.exceptions import InvalidArgument from google.cloud import documentai  # type: ignore  # TODO(developer): Uncomment these variables before running the sample. # project_id = 'YOUR_PROJECT_ID' # location = 'YOUR_PROCESSOR_LOCATION' # Format is 'us' or 'eu' # processor_id = 'YOUR_PROCESSOR_ID' # Create processor before running sample # processor_version_id = 'YOUR_PROCESSOR_VERSION_ID'   def undeploy_processor_version_sample(     project_id: str, location: str, processor_id: str, processor_version_id: str ) -> None:     # You must set the api_endpoint if you use a location other than 'us'.     opts = ClientOptions(api_endpoint=f"{location}-documentai.googleapis.com")      client = documentai.DocumentProcessorServiceClient(client_options=opts)      # The full resource name of the processor version     # e.g.: projects/project_id/locations/location/processors/processor_id/processorVersions/processor_version_id     name = client.processor_version_path(         project_id, location, processor_id, processor_version_id     )      # Make UndeployProcessorVersion request     try:         operation = client.undeploy_processor_version(name=name)         # Print operation details         print(operation.operation.name)         # Wait for operation to complete         operation.result()     # Undeploy request will fail if the     # processor version is already undeployed     # or if a request is made on a pretrained processor version     except (FailedPrecondition, InvalidArgument) as e:         print(e.message)  

Ruby

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Ruby.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

require "google/cloud/document_ai/v1"  ## # Snippet for the undeploy_processor_version call in the DocumentProcessorService service # # This snippet has been automatically generated and should be regarded as a code # template only. It will require modifications to work: # - It may require correct/in-range values for request initialization. # - It may require specifying regional endpoints when creating the service # client as shown in https://cloud.google.com/ruby/docs/reference. # # This is an auto-generated example demonstrating basic usage of # Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client#undeploy_processor_version. # def undeploy_processor_version   # Create a client object. The client can be reused for multiple calls.   client = Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client.new    # Create a request. To set request fields, pass in keyword arguments.   request = Google::Cloud::DocumentAI::V1::UndeployProcessorVersionRequest.new    # Call the undeploy_processor_version method.   result = client.undeploy_processor_version request    # The returned object is of type Gapic::Operation. You can use it to   # check the status of an operation, cancel it, or wait for results.   # Here is how to wait for a response.   result.wait_until_done! timeout: 60   if result.response?     p result.response   else     puts "No response received."   end end

Eliminare una versione del processore

Dopo aver creato una nuova versione del processore con Document AI, puoi eliminarla se non ti serve più.

Console

  1. Nella Google Cloud console, nella sezione Document AI, vai alla pagina Processori.

    Vai alla pagina Processori

  2. Nell'elenco dei responsabili del trattamento, fai clic sul nome di quello di cui vuoi visualizzare i dettagli.

  3. Nella scheda Gestisci versioni (o Implementa e utilizza) del processore, fai clic sul menu delle azioni accanto alla versione del processore da eliminare.

  4. Fai clic su Elimina, quindi di nuovo su Elimina nella finestra di dialogo.

REST

Questo esempio mostra come eliminare una versione del processore per il processore utilizzando il metodo processorVersions.delete.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • LOCATION: la posizione del responsabile del trattamento, ad esempio:
    • us - Stati Uniti
    • eu - Unione Europea
  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • PROCESSOR_ID: l'ID del tuo processore personalizzato.
  • PROCESSOR_VERSION: l'identificatore della versione del processore.

Metodo HTTP e URL:

DELETE https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"

PowerShell

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION" | Select-Object -Expand Content

La risposta è un'operazione a lunga esecuzione. Per eseguire il polling dell'operazione a lunga esecuzione, chiama operations.get

DeleteProcessorVersionMetadata nella risposta indica lo stato dell'operazione.

 {   "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION",   "metadata": {     "@type": "type.googleapis.com/google.cloud.documentai.v1.DeleteProcessorVersionMetadata",     "commonMetadata": {       "state": "SUCCEEDED",       "createTime": "2022-08-29T16:27:00.195539Z",       "updateTime": "2022-08-29T16:32:01.963962Z",       "resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/PROCESSOR_VERSION"     }   },   "done": true,   "response": {     "@type": "type.googleapis.com/google.protobuf.Empty"   } } 

C#

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per C#.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

using Google.Cloud.DocumentAI.V1; using Google.LongRunning; using Google.Protobuf.WellKnownTypes;  public sealed partial class GeneratedDocumentProcessorServiceClientSnippets {     /// <summary>Snippet for DeleteProcessorVersion</summary>     /// <remarks>     /// This snippet has been automatically generated and should be regarded as a code template only.     /// It will require modifications to work:     /// - It may require correct/in-range values for request initialization.     /// - It may require specifying regional endpoints when creating the service client as shown in     ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.     /// </remarks>     public void DeleteProcessorVersionRequestObject()     {         // Create client         DocumentProcessorServiceClient documentProcessorServiceClient = DocumentProcessorServiceClient.Create();         // Initialize request argument(s)         DeleteProcessorVersionRequest request = new DeleteProcessorVersionRequest         {             ProcessorVersionName = ProcessorVersionName.FromProjectLocationProcessorProcessorVersion("[PROJECT]", "[LOCATION]", "[PROCESSOR]", "[PROCESSOR_VERSION]"),         };         // Make the request         Operation<Empty, DeleteProcessorVersionMetadata> response = documentProcessorServiceClient.DeleteProcessorVersion(request);          // Poll until the returned long-running operation is complete         Operation<Empty, DeleteProcessorVersionMetadata> completedResponse = response.PollUntilCompleted();         // Retrieve the operation result         Empty result = completedResponse.Result;          // Or get the name of the operation         string operationName = response.Name;         // This name can be stored, then the long-running operation retrieved later by name         Operation<Empty, DeleteProcessorVersionMetadata> retrievedResponse = documentProcessorServiceClient.PollOnceDeleteProcessorVersion(operationName);         // Check if the retrieved long-running operation has completed         if (retrievedResponse.IsCompleted)         {             // If it has completed, then access the result             Empty retrievedResult = retrievedResponse.Result;         }     } }

Go

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Go.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 package main  import ( 	"context"  	documentai "cloud.google.com/go/documentai/apiv1" 	documentaipb "cloud.google.com/go/documentai/apiv1/documentaipb" )  func main() { 	ctx := context.Background() 	// This snippet has been automatically generated and should be regarded as a code template only. 	// It will require modifications to work: 	// - It may require correct/in-range values for request initialization. 	// - It may require specifying regional endpoints when creating the service client as shown in: 	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options 	c, err := documentai.NewDocumentProcessorClient(ctx) 	if err != nil { 		// TODO: Handle error. 	} 	defer c.Close()  	req := &documentaipb.DeleteProcessorVersionRequest{ 		// TODO: Fill request struct fields. 		// See https://pkg.go.dev/cloud.google.com/go/documentai/apiv1/documentaipb#DeleteProcessorVersionRequest. 	} 	op, err := c.DeleteProcessorVersion(ctx, req) 	if err != nil { 		// TODO: Handle error. 	}  	err = op.Wait(ctx) 	if err != nil { 		// TODO: Handle error. 	} } 

Java

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Java.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

import com.google.cloud.documentai.v1.DeleteProcessorVersionRequest; import com.google.cloud.documentai.v1.DocumentProcessorServiceClient; import com.google.cloud.documentai.v1.ProcessorVersionName; import com.google.protobuf.Empty;  public class SyncDeleteProcessorVersion {    public static void main(String[] args) throws Exception {     syncDeleteProcessorVersion();   }    public static void syncDeleteProcessorVersion() throws Exception {     // This snippet has been automatically generated and should be regarded as a code template only.     // It will require modifications to work:     // - It may require correct/in-range values for request initialization.     // - It may require specifying regional endpoints when creating the service client as shown in     // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library     try (DocumentProcessorServiceClient documentProcessorServiceClient =         DocumentProcessorServiceClient.create()) {       DeleteProcessorVersionRequest request =           DeleteProcessorVersionRequest.newBuilder()               .setName(                   ProcessorVersionName.of(                           "[PROJECT]", "[LOCATION]", "[PROCESSOR]", "[PROCESSOR_VERSION]")                       .toString())               .build();       documentProcessorServiceClient.deleteProcessorVersionAsync(request).get();     }   } }

Python

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Python.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

 from google.api_core.client_options import ClientOptions from google.api_core.exceptions import FailedPrecondition from google.api_core.exceptions import InvalidArgument from google.cloud import documentai  # type: ignore  # TODO(developer): Uncomment these variables before running the sample. # project_id = 'YOUR_PROJECT_ID' # location = 'YOUR_PROCESSOR_LOCATION' # Format is 'us' or 'eu' # processor_id = 'YOUR_PROCESSOR_ID' # Create processor before running sample # processor_version_id = 'YOUR_PROCESSOR_VERSION_ID'   def delete_processor_version_sample(     project_id: str, location: str, processor_id: str, processor_version_id: str ) -> None:     # You must set the api_endpoint if you use a location other than 'us'.     opts = ClientOptions(api_endpoint=f"{location}-documentai.googleapis.com")      client = documentai.DocumentProcessorServiceClient(client_options=opts)      # The full resource name of the processor version     # e.g.: projects/project_id/locations/location/processors/processor_id/processorVersions/processor_version_id     name = client.processor_version_path(         project_id, location, processor_id, processor_version_id     )      # Make DeleteProcessorVersion request     try:         operation = client.delete_processor_version(name=name)         # Print operation details         print(operation.operation.name)         # Wait for operation to complete         operation.result()     # Delete request will fail if the     # processor version doesn't exist     # or if a request is made on a pretrained processor version     # or the default processor version     except (FailedPrecondition, InvalidArgument) as e:         print(e.message)  

Ruby

Per saperne di più, consulta la documentazione di riferimento dell'API Document AI per Ruby.

Per autenticarti in Document AI, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configura l'autenticazione per un ambiente di sviluppo locale.

require "google/cloud/document_ai/v1"  ## # Snippet for the delete_processor_version call in the DocumentProcessorService service # # This snippet has been automatically generated and should be regarded as a code # template only. It will require modifications to work: # - It may require correct/in-range values for request initialization. # - It may require specifying regional endpoints when creating the service # client as shown in https://cloud.google.com/ruby/docs/reference. # # This is an auto-generated example demonstrating basic usage of # Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client#delete_processor_version. # def delete_processor_version   # Create a client object. The client can be reused for multiple calls.   client = Google::Cloud::DocumentAI::V1::DocumentProcessorService::Client.new    # Create a request. To set request fields, pass in keyword arguments.   request = Google::Cloud::DocumentAI::V1::DeleteProcessorVersionRequest.new    # Call the delete_processor_version method.   result = client.delete_processor_version request    # The returned object is of type Gapic::Operation. You can use it to   # check the status of an operation, cancel it, or wait for results.   # Here is how to wait for a response.   result.wait_until_done! timeout: 60   if result.response?     p result.response   else     puts "No response received."   end end

Importare una versione del processore

Dopo aver creato un nuovo processore con Document AI, puoi importare una versione del processore dallo stesso progetto o da un altro.

Il destination project è il punto di partenza dell'importazione e il luogo in cui la versione del processore diventa disponibile dopo l'importazione.

source project è la posizione della versione del processore di origine.

Per l'importazione, i processori di origine o di destinazione devono soddisfare i seguenti requisiti:

  • I tipi di processore devono corrispondere. Esempi: CUSTOM_EXTRACTION_PROCESSOR o INVOICE_PROCESSOR
  • Gli schemi del processore non devono essere in conflitto.
  • Il processore di destinazione può avere set di dati e versioni esistenti.
  • Il processore di destinazione deve essere nello stato ENABLED.
  • La versione del processore di origine deve trovarsi in uno dei seguenti stati:
    • DEPLOYED
    • DEPLOYING
    • UNDEPLOYED
    • UNDEPLOYING

Per evitare un errore di autorizzazione negata, devi concedere all'agente di servizio DocumentAI Core del progetto di destinazione l'autorizzazione Editor Document AI sul progetto di origine.

Per le versioni del processore basate su Gemini 1.5 e versioni successive, come estrattori personalizzati pretrained-foundation-model-v1.2-2024-05-10, puoi importare versioni del processore ottimizzate.

Per configurare l'autorizzazione prima di importare una versione del processore:

Console

  1. Cerca Agente servizio principale DocumentAI e inserisci il numero del progetto di destinazione. L'agente servizio principale DocumentAI è formattato come un indirizzo email. Ad esempio: [email protected]

  2. Apri la pagina IAM nella console Google Cloud .

    Apri la pagina IAM

  3. Seleziona il progetto di origine.

  4. Fai clic su Concedi l'accesso.

  5. Aggiungi l'agente di servizio principale DocumentAI del progetto di destinazione come nuova entità e assegna il ruolo Editor Document AI.

gcloud

Utilizza il seguente comando gcloud per concedere le autorizzazioni necessarie:

gcloud projects add-iam-policy-binding SOURCE_PROJECT \     --member=serviceAccount:service-DESTINATION_PROJECT NUMBER@gcp-sa-prod-dai-core.iam.gserviceaccount.com \     --role=roles/documentai.editor

Fornisci i seguenti valori:

  • SOURCE_PROJECT: Il numero o l'ID del progetto di origine.
  • DESTINATION_PROJECT NUMBER: il numero del progetto di destinazione.

Dopo aver aggiornato le autorizzazioni, segui questi passaggi per importare una versione del processore:

Console

  1. Nella Google Cloud console, nella sezione Document AI, vai alla pagina Processori.

    Vai alla pagina Processori

  2. Nell'elenco dei processori, fai clic sul nome del processore in cui vuoi importare una versione del processore come processore di destinazione.

  3. Vai alla scheda Gestisci versioni (o Deployment e utilizzo) e fai clic su Importa.

  4. Scegli il progetto, il processore e la versione del processore come versione del processore di origine nella finestra.

  5. Fai clic sul pulsante IMPORTA nella finestra e l'operazione di importazione verrà avviata.

REST

Questo esempio mostra come utilizzare il metodo processorVersions.importProcessorVersion per importare una versione del processore.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • Progetto di destinazione
    • DESTINATION_PROJECT_ID: l'ID progetto Google Cloud di destinazione.
    • DESTINATION_LOCATION: la posizione del processore di destinazione.
    • DESTINATION_PROCESSOR_ID: l'ID del processore di destinazione.
  • Progetto di origine
    • SOURCE_PROJECT_ID: il tuo ID progetto Google Cloud di origine.
    • SOURCE_LOCATION: la posizione del processore di origine.
    • SOURCE_PROCESSOR_ID: l'ID del processore di origine.
    • SOURCE_PROCESSOR_VERSION: la versione del processore di origine da importare.

Metodo HTTP e URL:

POST https://DESTINATION_LOCATION-documentai.googleapis.com/v1beta3/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/processors/DESTINATION_PROCESSOR_ID/processorVersions:importProcessorVersion

Corpo JSON della richiesta:

 {   "processorVersionSource": "projects/SOURCE_PROJECT_ID/locations/SOURCE_LOCATION/processors/SOURCE_PROCESSOR_ID/processorVersions/SOURCE_PROCESSOR_VERSION" } 

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, ed esegui questo comando:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://DESTINATION_LOCATION-documentai.googleapis.com/v1beta3/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/processors/DESTINATION_PROCESSOR_ID/processorVersions:importProcessorVersion"

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://DESTINATION_LOCATION-documentai.googleapis.com/v1beta3/projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/processors/DESTINATION_PROCESSOR_ID/processorVersions:importProcessorVersion" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

 {   "name": "projects/DESTINATION_PROJECT_ID/locations/DESTINATION_LOCATION/operations/OPERATION_ID" } 

Se importi dati in un perimetro dei Controlli di servizio VPC (VPC-SC), consulta Configurazione dei criteri in entrata e in uscita e Configurare un perimetro dei Controlli di servizio VPC, poi imposta le seguenti regole.

Fornisci i seguenti valori per ingress:

  • DESTINATION_PROJECT: il numero del progetto di destinazione.
  • SOURCE_PROJECT: il numero del progetto di origine.
 - ingressFrom:     identities:     - ANY_SERVICE_ACCOUNT     sources:     - resource: DESTINATION_PROJECT   ingressTo:     operations:     - serviceName: aiplatform.googleapis.com       methodSelectors:       - method: all actions     - serviceName: documentai.googleapis.com       methodSelectors:       - method: all actions     resources:     - projects/SOURCE_PROJECT 

Fornisci i seguenti valori per egress:

 - egressTo:     operations:     - serviceName: storage.googleapis.com       methodSelectors:       - method: google.storage.objects.create       - method: google.storage.buckets.testIamPermissions     resources:     - projects/DESTINATION_PROJECT   egressFrom:     identities:     - ANY_SERVICE_ACCOUNT 

Configura un perimetro di destinazione VPC con i seguenti valori.

 - egressTo:     operations:     - serviceName: aiplatform.googleapis.com       methodSelectors:       - method: all actions     - serviceName: documentai.googleapis.com       methodSelectors:       - method: all actions     - serviceName: storage.googleapis.com       methodSelectors:       - method: google.storage.buckets.testIamPermissions       - method: google.storage.objects.get       - method: google.storage.objects.create     resources:     - projects/SOURCE_PROJECT   egressFrom:     identities:     - ANY_SERVICE_ACCOUNT     sourceRestriction: DISABLED 

Passaggi successivi