Como migrar da v1Beta2

A API v1beta2 da Document AI foi descontinuada e substituída pela API v1.

Ao contrário da v1beta2, a Document AI v1 é uma API com estado, o que significa que você precisa criar um Processor antes de enviar solicitações para os documentos Process e BatchProcess.

OBSERVAÇÃO: essa descontinuação afeta apenas a versão da API usada para chamar qualquer processador. Isso não afeta a disponibilidade de nenhum processador.

As principais áreas de incompatibilidade de versões anteriores da API v1 com a API v1beta2 são discutidas mais adiante neste documento.

Como criar um processador

Para migrar para v1 na criação de processadores, primeiro crie um Processor. A tabela a seguir serve como uma diretriz geral para escolher um ProcessorType adequado para criar, mas você pode consultar a lista completa de processadores.

document_type	params	Tipo de processador
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

Para conferir um guia explicativo sobre como criar um processador, acesse o guia.

Processando documentos

A Document AI v1 tem duas APIs para aceitar documentos: Process e BatchProcess. Cada um desses métodos corresponde a um método de v1beta2. Os métodos e as diferenças deles são destacados:

Método v1beta2	Método v1	Notas de migração
ProcessDocument	Process	InputConfig.Cloud Storage_source não tem suporte em v1. Use BatchProcess para processar documentos no Cloud Storage.
BatchProcessDocuments	BatchProcess	Além de aceitar documentos individuais no Cloud Storage, o v1 oferece suporte a um prefixo do Cloud Storage para processar muitos documentos de uma só vez.

Bibliotecas de cliente

Se você estiver usando o Client Libraries para interagir com a Document AI, mude do DocumentUnderstandingService para o DocumentProcessorService. Para conferir um exemplo detalhado de como usar as bibliotecas de cliente para v1, consulte bibliotecas de cliente.