V1Beta2 からの移行

Document AI の v1beta2 API は非推奨となり、v1 API が推奨されるようになりました。

v1beta2 とは異なり、Document AI v1 はステートフル API です。つまり、Process ドキュメントと BatchProcess ドキュメントにリクエストを送信する前に、Processor を作成する必要があります。

注: この非推奨は、プロセッサの呼び出しに使用される API のバージョンにのみ影響します。プロセッサの可用性には影響しません。

v1 API と v1beta2 API の下位互換性がない主な領域については、このドキュメントの後半で説明します。

プロセッサの作成

プロセッサの作成に v1 に移行するには、まず Processor を作成します。次の表は、作成する適切な ProcessorType を選択するための一般的なガイドラインですが、プロセッサの完全なリストを参照することもできます。

document_type params プロセッサ タイプ
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

プロセッサの作成手順については、ガイドをご覧ください。

ドキュメントの処理中です

Document AI v1 には、ドキュメントを受け入れる 2 つの API(ProcessBatchProcess)があります。これらの各メソッドは、v1beta2 のメソッドに対応しています。メソッドとその違いを以下に示します。

v1beta2 メソッド v1 メソッド 移行に関する注意事項
ProcessDocument Process InputConfig.Cloud Storage_sourcev1 でサポートされていません。Cloud Storage でドキュメントを処理するには、BatchProcess を使用します。
BatchProcessDocuments BatchProcess v1 は、Cloud Storage 上の個々のドキュメントを受け入れるだけでなく、Cloud Storage プレフィックスをサポートして、多くのドキュメントを一度に処理します。

クライアント ライブラリ

Client Libraries を使用して Document AI とやり取りする場合は、DocumentUnderstandingService の使用から DocumentProcessorService の使用に切り替えます。v1 のクライアント ライブラリの使用例については、クライアント ライブラリをご覧ください。