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（Process と BatchProcess）があります。これらの各メソッドは、v1beta2 のメソッドに対応しています。メソッドとその違いを以下に示します。
v1beta2 メソッド |
v1 メソッド |
移行に関する注意事項 |
|---|---|---|
ProcessDocument |
Process |
InputConfig.Cloud Storage_source は v1 でサポートされていません。Cloud Storage でドキュメントを処理するには、BatchProcess を使用します。 |
BatchProcessDocuments |
BatchProcess |
v1 は、Cloud Storage 上の個々のドキュメントを受け入れるだけでなく、Cloud Storage プレフィックスをサポートして、多くのドキュメントを一度に処理します。 |
クライアント ライブラリ
Client Libraries を使用して Document AI とやり取りする場合は、DocumentUnderstandingService の使用から DocumentProcessorService の使用に切り替えます。v1 のクライアント ライブラリの使用例については、クライアント ライブラリをご覧ください。