翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # GetExpenseAnalysis 請求書と領収書を分析する Amazon Textract 非同期オペレーションの結果を取得します。Amazon Textract は、入力された請求書と領収書から、連絡先情報、購入した商品、およびベンダー名を検索します。 非同期請求書/領収書の分析を開始するには、[StartExpenseAnalysis](API_StartExpenseAnalysis.md)。ジョブ識別子 (`JobId`). 請求書/領収分析が完了すると、Amazon Simple Notification Service (Amazon SNS) トピックに完了ステータスが発行されます。このトピックは、への最初の呼び出しで登録する必要があります。`StartExpenseAnalysis`。請求書/領収分析オペレーションの結果を取得するには、Amazon SNS トピックに発行されたステータス値が`SUCCEEDED`。もしそうなら、電話してください`GetExpenseAnalysis`を選択し、ジョブ識別子を渡します (`JobId`) を最初の呼び出しから`StartExpenseAnalysis`。 MaxResults パラメーターを使用して、返されるブロックの数を制限します。で指定した数を超える結果がある場合`MaxResults`とすると、の値`NextToken`オペレーションレスポンスには、次の結果セットを取得するためのページ割りトークンが含まれています。次の結果ページを取得するには、`GetExpenseAnalysis`を入力し、`NextToken`前回の呼び出しから返されたトークン値を持つリクエストパラメータ`GetExpenseAnalysis`。 詳細については、「」を参照してください。[請求書と領収書の分析](https://docs.aws.amazon.com/textract/latest/dg/invoices-receipts.html)。 ## リクエストの構文 ``` { "JobId": "string", "MaxResults": number, "NextToken": "string" } ``` ## リクエストパラメータ リクエストは以下の JSON 形式のデータを受け入れます。 ** [JobId](#API_GetExpenseAnalysis_RequestSyntax) ** テキスト検出ジョブの一意の識別子。-`JobId`から返される`StartExpenseAnalysis`。ある`JobId`値は 7 日間だけ有効です。 Type: 文字列 長さの制約: 最小長は 1 です｡ 最大長は 64 です。 パターン: `^[a-zA-Z0-9-_]+$` 必須: はい ** [MaxResults](#API_GetExpenseAnalysis_RequestSyntax) ** ページ割りコールごとに返す結果の最大数。指定できる最大値は 20 です。20 より大きい値を指定した場合、最大 20 件の結果が返されます。デフォルト値は 20 です。 Type: 整数 有効範囲: 最小値は 1 です。 必須: いいえ ** [NextToken](#API_GetExpenseAnalysis_RequestSyntax) ** 前のレスポンスが不完全だった場合 (取得するブロックが多いため)、Amazon Textract はレスポンスでページ割りトークンを返します。このページ割りトークンを使用して、次のブロックのセットを取得できます。 Type: 文字列 長さの制約: 最小長は 1 です｡ 最大長は 255 です。 パターン: `.*\S.*` 必須: いいえ ## レスポンスの構文 ``` { "AnalyzeExpenseModelVersion": "string", "DocumentMetadata": { "Pages": number }, "ExpenseDocuments": [ { "ExpenseIndex": number, "LineItemGroups": [ { "LineItemGroupIndex": number, "LineItems": [ { "LineItemExpenseFields": [ { "LabelDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" }, "PageNumber": number, "Type": { "Confidence": number, "Text": "string" }, "ValueDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" } } ] } ] } ], "SummaryFields": [ { "LabelDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" }, "PageNumber": number, "Type": { "Confidence": number, "Text": "string" }, "ValueDetection": { "Confidence": number, "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Text": "string" } } ] } ], "JobStatus": "string", "NextToken": "string", "StatusMessage": "string", "Warnings": [ { "ErrorCode": "string", "Pages": [ number ] } ] } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [AnalyzeExpenseModelVersion](#API_GetExpenseAnalysis_ResponseSyntax) ** AnalyzeExpense の現在のモデルバージョンです。 Type: 文字列 ** [DocumentMetadata](#API_GetExpenseAnalysis_ResponseSyntax) ** Amazon Textract が処理したドキュメントに関する情報。`DocumentMetadata`は、Amazon Textract オペレーションからページ分割されたレスポンスの各ページに返されます。 型: [DocumentMetadata](API_DocumentMetadata.md) オブジェクト ** [ExpenseDocuments](#API_GetExpenseAnalysis_ResponseSyntax) ** Amazon Textract によって検出された経費。 Type: 配列の[ExpenseDocument](API_ExpenseDocument.md)オブジェクト ** [JobStatus](#API_GetExpenseAnalysis_ResponseSyntax) ** テキスト検出ジョブの現在のステータス。 Type: 文字列 有効な値: ` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` ** [NextToken](#API_GetExpenseAnalysis_ResponseSyntax) ** レスポンスが切り捨てられると、Amazon Textract はこのトークンを返します。後続のリクエストでこのトークンを使用して、次のテキスト検出結果セットを取得できます。 Type: 文字列 長さの制約: 最小長は 1 です｡ 最大長は 255 です。 パターン: `.*\S.*` ** [StatusMessage](#API_GetExpenseAnalysis_ResponseSyntax) ** 検出ジョブを完了できなかった場合に返します。発生したエラーの説明が含まれています。 Type: 文字列 ** [Warnings](#API_GetExpenseAnalysis_ResponseSyntax) ** ドキュメントのテキスト検出操作中に発生した警告のリスト。 Type: 配列の[Warning](API_Warning.md)オブジェクト ## エラー ** AccessDeniedException ** そのアクションを実行する権限がありません。そのオペレーションを実行するには、承認されたユーザーまたは IAM ロールの Amazon リソースネーム (ARN) を使用します。 HTTP ステータスコード: 400 ** InternalServerError ** Amazon Textract でサービスの問題が発生しました。もう一度やり直してください。 HTTP ステータスコード: 500 ** InvalidJobIdException ** 無効なジョブ識別子が渡されました[GetDocumentAnalysis](API_GetDocumentAnalysis.md)または[GetDocumentAnalysis](API_GetDocumentAnalysis.md)。 HTTP ステータスコード: 400 ** InvalidKMSKeyException ** KMS キーが入力された状態で復号化権限がないか、KMS キーが誤って入力されたことを示します。 HTTP ステータスコード: 400 ** InvalidParameterException ** 入力パラメータが制約に違反しています。たとえば、同期操作では`InvalidParameterException`例外が発生するのは、どちらも`S3Object`または`Bytes`値は、`Document`リクエストパラメータ。API オペレーションを再度呼び出す前にパラメータを検証します。 HTTP ステータスコード: 400 ** InvalidS3ObjectException ** Amazon Textract は、リクエストで指定された S3 オブジェクトにアクセスできません。詳細については、[Amazon S3 へのアクセスの設定](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)トラブルシューティング情報については、「」を参照してください。[Amazon S3 トラブルシューティング](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html) HTTP ステータスコード: 400 ** ProvisionedThroughputExceededException ** お客様のスループット制限を超えたリクエストの数。この上限を引き上げる場合は、Amazon Textract までお問い合わせください。 HTTP ステータスコード: 400 ** ThrottlingException ** Amazon Textract は一時的にリクエストを処理できませんでした。もう一度やり直してください。 HTTP ステータスコード: 500 ## 以下の資料も参照してください。 言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください： + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetExpenseAnalysis) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetExpenseAnalysis) + [AWS SDK for Ruby v3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetExpenseAnalysis)