Migrating from V1Beta2
Document AI'sv1beta2 API is now deprecated in favor of thev1 API.
Unlikev1beta2, Document AIv1is a stateful API, meaning you need to create aProcessorbefore you can send requests toProcessandBatchProcessdocuments.
NOTE: This deprecation only affects the version of the API used to call any processor.It does not affect the availability of any processor.
The major areas of v1 API backward incompatibility with v1beta2 API are discussedlater in this document.
Creating a processor
To migrate tov1 for processor creation, first create aProcessor. The following table serves as a general guideline for choosing an appropriateProcessorTypeto create, but you can consult the fullprocessor list.
document_type | params | Processor type |
|---|---|---|
invoice | INVOICE_PROCESSOR | |
general | OCR_PROCESSOR | |
general | table_extraction_params | FORM_PARSER_PROCESSOR |
general | form_extraction_params | FORM_PARSER_PROCESSOR |
general | entity_extraction_params | FORM_PARSER_PROCESSOR |
general | automl_params | CUSTOM_EXTRACTION_PROCESSOR |
For a step-by-step guide to creating a processor, view theguide.
Processing documents
Document AIv1 has two APIs to accept documents:Process andBatchProcess.Each of these methods corresponds to a method fromv1beta2. The methods andtheir differences are highlighted:
v1beta2 Method | v1 Method | Migration notes |
|---|---|---|
ProcessDocument | Process | InputConfig.Cloud Storage_source not supported inv1, useBatchProcess to process documents on Cloud Storage. |
BatchProcessDocuments | BatchProcess | In addition to accepting individual documents on Cloud Storage,v1 supports a Cloud Storage prefix to process many documents at once. |
Client libraries
If using theClient Libraries to interact withDocument AI, switch from using theDocumentUnderstandingService to theDocumentProcessorService. For a detailed example of using the client librariesforv1, seeclient libraries.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.