Google Cloud アカウントを設定し、プロセッサを作成して、人間による審査を有効にしたら、プロセッサに審査リクエストを送信できます。このページでは、ドキュメントの人間による確認をアドホックにリクエストする方法について説明します。
人間による審査をリクエストする
ウェブ UI
Google Cloud コンソールで [Human-in-the-Loop] ページを開きます。
手動レビューに使用するプロセッサをクリックします。
[ドキュメントをアップロード] を選択し、審査に送るローカル ファイルをアップロードします。ドキュメントが審査キューに表示されるまで 1 ~ 2 分かかります。
REST
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: 実際の Google Cloud プロジェクト ID。
- LOCATION: プロセッサのロケーション(例:
-
)
us
- 米国eu
- 欧州連合
- PROCESSOR_ID: カスタム プロセッサの ID。
- ENABLE_SCHEMA_VALIDATION: アドホック レビュー リクエストでスキーマ検証を実行するかどうか。
true
- アドホック レビュー リクエストでスキーマ検証を有効にします。false
- アドホック審査リクエストのスキーマ検証を無効にします。
- PRIORITY: 人間による審査タスクの優先度。
DEFAULT
- デフォルトの優先度。URGENT
- 緊急の優先度。ラベル付けマネージャーは、この優先度を尊重するために、ラベル付け担当者のリソースを緊急タスクキューに割り当てる必要があります。
- DOCUMENT: 審査用に構成されたプロセッサによってすでに処理されている
Document
オブジェクト。
HTTP メソッドと URL:
POST https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/humanReviewConfig:reviewDocument
リクエストの本文(JSON):
{ "enableSchemaValidation": ENABLE_SCHEMA_VALIDATION, "priority": "PRIORITY", "inlineDocument": "DOCUMENT" }
リクエストを送信するには、次のいずれかのオプションを選択します。
curl
リクエスト本文を request.json
という名前のファイルに保存して、次のコマンドを実行します。
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/humanReviewConfig:reviewDocument"
PowerShell
リクエスト本文を request.json
という名前のファイルに保存して、次のコマンドを実行します。
$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/humanReviewConfig:reviewDocument" | Select-Object -Expand Content
リクエストが成功した場合、レスポンスには Operation
のインスタンスが含まれます。長時間実行オペレーションの詳細については、ドキュメントをご覧ください。
{ "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.documentai.v1.ReviewDocumentOperationMetadata", "commonMetadata": { "state": "RUNNING", "createTime": "TIMESTAMP", "updateTime": "TIMESTAMP", "resource": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/humanReviewConfig" } } }
Python
詳細については、Document AI Python API リファレンス ドキュメントをご覧ください。
Document AI に対する認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証の設定をご覧ください。