기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# API 참조
이 단원에서는 Amazon Textract API 작업에 대한 설명서를 제공합니다.
**Topics**
+ [작업](API_Operations.md)
+ [데이터 유형](API_Types.md)
# 작업
다음 작업이 지원됩니다.
+ [AnalyzeDocument](API_AnalyzeDocument.md)
+ [AnalyzeExpense](API_AnalyzeExpense.md)
+ [AnalyzeID](API_AnalyzeID.md)
+ [DetectDocumentText](API_DetectDocumentText.md)
+ [GetDocumentAnalysis](API_GetDocumentAnalysis.md)
+ [GetDocumentTextDetection](API_GetDocumentTextDetection.md)
+ [GetExpenseAnalysis](API_GetExpenseAnalysis.md)
+ [StartDocumentAnalysis](API_StartDocumentAnalysis.md)
+ [StartDocumentTextDetection](API_StartDocumentTextDetection.md)
+ [StartExpenseAnalysis](API_StartExpenseAnalysis.md)
# AnalyzeDocument
검색된 항목 간의 관계에 대한 입력 문서를 분석합니다.
반환되는 정보의 유형은 다음과 같습니다.
+ 양식 데이터 (키-값 페어) 관련 정보는 2로 반환됩니다.[Block](API_Block.md)객체, 각 유형`KEY_VALUE_SET`: 키`Block`객체 및 값`Block`객체입니다. 예,*이름: 아나 실바 캐롤라이나*에는 키와 값이 포함되어 있습니다. *이름:*열쇠입니다. *아나 실바 캐롤라이나*이 값입니다.
+ 테이블 및 테이블 셀 데이터입니다. 테이블`Block`객체에는 탐지된 테이블에 대한 정보가 들어 있습니다. 셀`Block`테이블의 각 셀에 대해 객체가 반환됩니다.
+ 줄 및 텍스트 단어. 줄 바꿈`Block`객체가 하나 이상의 WORD가 포함되어 있습니다.`Block`객체입니다. 문서에서 감지된 모든 줄과 단어가 반환됩니다 (값과 관계가 없는 텍스트 포함)`FeatureTypes`).
확인란 및 옵션 버튼 (라디오 버튼) 과 같은 선택 요소는 양식 데이터 및 테이블에서 감지할 수 있습니다. 셀렉션\$1엘리먼트`Block`객체에는 선택 상태를 포함하여 선택 요소에 대한 정보가 들어 있습니다.
다음을 지정하여 수행할 분석 유형을 선택할 수 있습니다.`FeatureTypes`나열.
출력은 다음 목록에 반환됩니다.`Block`객체입니다.
`AnalyzeDocument`는 동기식 작업입니다. 문서를 비동기적으로 분석하려면[StartDocumentAnalysis](API_StartDocumentAnalysis.md).
자세한 내용은 단원을 참조하십시오.[문서 분석](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html).
## 요청 구문
```
{
"Document": {
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
},
"FeatureTypes": [ "string" ],
"HumanLoopConfig": {
"DataAttributes": {
"ContentClassifiers": [ "string" ]
},
"FlowDefinitionArn": "string",
"HumanLoopName": "string"
}
}
```
## 요청 파라미터
요청은 JSON 형식의 다음 데이터를 받습니다.
** [Document](#API_AnalyzeDocument_RequestSyntax) **
입력 문서인 base64로 인코딩된 바이트 또는 Amazon S3 객체입니다. AWS CLI를 사용하여 Amazon Textract 작업을 호출하는 경우 이미지 바이트를 전달할 수 없습니다. 문서는 JPEG, PNG, PDF 또는 TIFF 형식의 이미지여야 합니다.
AWS SDK를 사용하여 Amazon Textract Textract를 호출하는 경우 다음을 사용하여 전달된 이미지 바이트를 base64로 인코딩할 필요가 없습니다.`Bytes`필드.
유형: [Document](API_Document.md) 객체
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** [FeatureTypes](#API_AnalyzeDocument_RequestSyntax) **
수행할 분석 유형의 목록입니다. 목록에 TABLES를 추가하여 입력 문서에서 검색된 테이블에 대한 정보를 반환합니다. FORMS를 추가하여 검색된 양식 데이터를 반환합니다. 두 가지 유형의 분석을 모두 수행하려면 TABLES 및 FORMS를`FeatureTypes`. 문서에서 감지된 모든 줄과 단어가 응답에 포함됩니다 (값과 관련이 없는 텍스트 포함)`FeatureTypes`).
Type: 문자열 배열
유효한 값:` TABLES | FORMS`
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** [HumanLoopConfig](#API_AnalyzeDocument_RequestSyntax) **
문서 분석을 위한 루프 워크플로우에서 사람에 대한 구성을 설정합니다.
유형: [HumanLoopConfig](API_HumanLoopConfig.md) 객체
: 필수 아니요
## 응답 구문
```
{
"AnalyzeDocumentModelVersion": "string",
"Blocks": [
{
"BlockType": "string",
"ColumnIndex": number,
"ColumnSpan": number,
"Confidence": number,
"EntityTypes": [ "string" ],
"Geometry": {
"BoundingBox": {
"Height": number,
"Left": number,
"Top": number,
"Width": number
},
"Polygon": [
{
"X": number,
"Y": number
}
]
},
"Id": "string",
"Page": number,
"Relationships": [
{
"Ids": [ "string" ],
"Type": "string"
}
],
"RowIndex": number,
"RowSpan": number,
"SelectionStatus": "string",
"Text": "string",
"TextType": "string"
}
],
"DocumentMetadata": {
"Pages": number
},
"HumanLoopActivationOutput": {
"HumanLoopActivationConditionsEvaluationResults": "string",
"HumanLoopActivationReasons": [ "string" ],
"HumanLoopArn": "string"
}
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [AnalyzeDocumentModelVersion](#API_AnalyzeDocument_ResponseSyntax) **
문서를 분석하는 데 사용된 모델 버전입니다.
Type: String
** [Blocks](#API_AnalyzeDocument_ResponseSyntax) **
에 의해 감지되고 분석되는 항목`AnalyzeDocument`.
Type: 어레이[Block](API_Block.md)사물
** [DocumentMetadata](#API_AnalyzeDocument_ResponseSyntax) **
분석된 문서에 대한 메타데이터입니다. 페이지 수를 예로 들 수 있습니다.
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체
** [HumanLoopActivationOutput](#API_AnalyzeDocument_ResponseSyntax) **
루프 평가에서 사람의 결과를 표시합니다.
유형: [HumanLoopActivationOutput](API_HumanLoopActivationOutput.md) 객체
## 오류
** AccessDeniedException **
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.
HTTP 상태 코드: 400
** BadDocumentException **
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).
HTTP 상태 코드: 400
** DocumentTooLargeException **
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.
HTTP 상태 코드: 400
** HumanLoopQuotaExceededException **
사용 가능한 루프 워크플로의 최대 개수를 초과했음을 나타냅니다.
HTTP 상태 코드: 400
** InternalServerError **
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** InvalidParameterException **
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음에 제공됩니다.`Document`요청 파라미터입니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.
HTTP 상태 코드: 400
** InvalidS3ObjectException **
Amazon Textract 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 Textract에 문의하십시오.
HTTP 상태 코드: 400
** ThrottlingException **
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** UnsupportedDocumentException **
입력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.
HTTP 상태 코드: 400
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeDocument)
+ [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeDocument)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeDocument)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeDocument)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeDocument)
+ [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeDocument)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeDocument)
+ [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeDocument)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeDocument)
# AnalyzeExpense
`AnalyzeExpense`텍스트 간의 재정적으로 관련된 관계에 대한 입력 문서를 동기적으로 분석합니다.
정보는 다음과 같이 반환됩니다.`ExpenseDocuments`다음과 같이 분리됩니다.
+ `LineItemGroups`- 다음을 포함하는 데이터 세트`LineItems`구매한 품목과 영수증에 가격 등 텍스트 줄에 대한 정보를 저장합니다.
+ `SummaryFields`- 헤더 정보 또는 공급업체 이름과 같은 영수증에 다른 모든 정보가 들어 있습니다.
## 요청 구문
```
{
"Document": {
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
}
```
## 요청 파라미터
요청은 JSON 형식의 다음 데이터를 받습니다.
** [Document](#API_AnalyzeExpense_RequestSyntax) **
입력 문서 (바이트 또는 S3 객체) 입니다.
를 사용하여 Amazon Textract API 작업에 이미지 바이트를 전달합니다.`Bytes`속성입니다. 예를 들어 를 사용합니다.`Bytes`로컬 파일 시스템에서 로드된 문서를 전달하는 속성입니다. 를 사용하여 전달된 이미지 바이트`Bytes`속성입니다 base64로 인코딩해야 합니다. AWS SDK를 사용하여 Amazon Textract API 작업을 호출하는 경우 코드가 문서 파일 바이트를 인코딩하지 않아도 될 수 있습니다.
다음을 사용하여 S3 버킷에 저장된 이미지를 Amazon Textract API 작업으로 전달합니다.`S3Object`속성입니다. S3 버킷에 저장된 문서는 base64로 인코딩할 필요가 없습니다.
S3 객체가 있는 S3 버킷의 AWS 리전과 Amazon Textract 작업에 사용하는 AWS 리전이 일치해야 합니다.
AWS CLI를 사용하여 Amazon Textract 작업을 호출하는 경우 바이트 속성을 사용하여 이미지 바이트를 전달하는 작업은 지원되지 않습니다. 먼저 문서를 Amazon S3 버킷에 업로드한 다음 S3Object 속성을 사용하여 작업을 호출해야 합니다.
Amazon Textract Textract가 S3 객체를 처리하려면 사용자에게 S3 객체에 액세스할 수 있는 권한이 있어야 합니다.
유형: [Document](API_Document.md) 객체
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
## 응답 구문
```
{
"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"
}
}
]
}
]
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [DocumentMetadata](#API_AnalyzeExpense_ResponseSyntax) **
입력 문서에 대한 정보입니다.
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체
** [ExpenseDocuments](#API_AnalyzeExpense_ResponseSyntax) **
Amazon Textract Textract에서 감지한 비용입니다.
Type: 배열[ExpenseDocument](API_ExpenseDocument.md)사물
## 오류
** AccessDeniedException **
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.
HTTP 상태 코드: 400
** BadDocumentException **
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).
HTTP 상태 코드: 400
** DocumentTooLargeException **
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.
HTTP 상태 코드: 400
** InternalServerError **
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** InvalidParameterException **
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음 위치에 제공됩니다.`Document`요청 파라미터입니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.
HTTP 상태 코드: 400
** InvalidS3ObjectException **
Amazon Textract 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 Textract에 문의하십시오.
HTTP 상태 코드: 400
** ThrottlingException **
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** UnsupportedDocumentException **
출력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.
HTTP 상태 코드: 400
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeExpense)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeExpense)
+ [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeExpense)
# AnalyzeID
관련 정보에 대한 ID 문서를 분석합니다. 이 정보는 추출되어 다음과 같이 반환됩니다.`IdentityDocumentFields`추출된 텍스트의 정규화된 필드와 값을 모두 기록합니다. 다른 Amazon Textract 작업과 달리`AnalyzeID`는 지오메트리 데이터를 반환하지 않습니다.
## 요청 구문
```
{
"DocumentPages": [
{
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
]
}
```
## 요청 파라미터
요청은 JSON 형식의 다음 데이터를 받습니다.
** [DocumentPages](#API_AnalyzeID_RequestSyntax) **
애널리제이드에 전달되는 문서입니다.
Type: 배열[Document](API_Document.md)사물
어레이 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 2개입니다.
필수 항목: 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
## 응답 구문
```
{
"AnalyzeIDModelVersion": "string",
"DocumentMetadata": {
"Pages": number
},
"IdentityDocuments": [
{
"DocumentIndex": number,
"IdentityDocumentFields": [
{
"Type": {
"Confidence": number,
"NormalizedValue": {
"Value": "string",
"ValueType": "string"
},
"Text": "string"
},
"ValueDetection": {
"Confidence": number,
"NormalizedValue": {
"Value": "string",
"ValueType": "string"
},
"Text": "string"
}
}
]
}
]
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [AnalyzeIDModelVersion](#API_AnalyzeID_ResponseSyntax) **
문서를 처리하는 데 사용되는 애널리틱스 아이덴티티 API의 버전입니다.
Type: String
** [DocumentMetadata](#API_AnalyzeID_ResponseSyntax) **
입력 문서에 대한 정보입니다.
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체
** [IdentityDocuments](#API_AnalyzeID_ResponseSyntax) **
AnalyzeID에서 처리한 문서 목록입니다. 목록에 있는 위치를 나타내는 번호와 문서에 대한 응답 구조를 포함합니다.
Type: 배열[IdentityDocument](API_IdentityDocument.md)사물
## 오류
** AccessDeniedException **
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.
HTTP 상태 코드: 400
** BadDocumentException **
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).
HTTP 상태 코드: 400
** DocumentTooLargeException **
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.
HTTP 상태 코드: 400
** InternalServerError **
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** InvalidParameterException **
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음 위치에 제공됩니다.`Document`요청 파라미터를 지정합니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.
HTTP 상태 코드: 400
** InvalidS3ObjectException **
Amazon Textract 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 Textract에 문의하십시오.
HTTP 상태 코드: 400
** ThrottlingException **
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** UnsupportedDocumentException **
입력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.
HTTP 상태 코드: 400
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeID)
+ [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeID)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeID)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeID)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeID)
+ [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeID)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeID)
+ [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeID)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeID)
# DetectDocumentText
입력 문서에서 텍스트를 감지합니다. Amazon Textract Textract는 텍스트 줄과 텍스트 한 줄을 구성하는 단어를 감지할 수 있습니다. 입력 문서는 JPEG, PNG, PDF 또는 TIFF 형식의 이미지여야 합니다.`DetectDocumentText`검색된 텍스트를 다음 배열로 반환합니다.[Block](API_Block.md)객체.
각 문서 페이지에는 연결된 페이지가 있습니다.`Block`페이지 유형입니다. 각 페이지`Block`객체가 LINE의 상위`Block`페이지에서 감지된 텍스트 행을 나타내는 개체입니다. 줄 바꿈`Block`object는 선을 구성하는 각 단어의 부모입니다. 단어는 다음과 같이 표시됩니다.`Block`WORD 유형의 객체입니다.
`DetectDocumentText`은 동기식 작업입니다. 문서를 비동기적으로 분석하려면[StartDocumentTextDetection](API_StartDocumentTextDetection.md).
자세한 내용은 단원을 참조하십시오.[문서 텍스트 감지](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html).
## 요청 구문
```
{
"Document": {
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
}
```
## 요청 파라미터
요청은 JSON 형식의 다음 데이터를 받습니다.
** [Document](#API_DetectDocumentText_RequestSyntax) **
입력 문서인 base64로 인코딩된 바이트 또는 Amazon S3 객체입니다. AWS CLI를 사용하여 Amazon Textract 작업을 호출하는 경우 이미지 바이트를 전달할 수 없습니다. 이 문서는 JPEG 또는 PNG 형식의 이미지여야 합니다.
AWS SDK를 사용하여 Amazon Textract Textract를 호출하는 경우 다음을 사용하여 전달된 이미지 바이트를 base64로 인코딩할 필요가 없습니다.`Bytes`필드.
유형: [Document](API_Document.md) 객체
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
## 응답 구문
```
{
"Blocks": [
{
"BlockType": "string",
"ColumnIndex": number,
"ColumnSpan": number,
"Confidence": number,
"EntityTypes": [ "string" ],
"Geometry": {
"BoundingBox": {
"Height": number,
"Left": number,
"Top": number,
"Width": number
},
"Polygon": [
{
"X": number,
"Y": number
}
]
},
"Id": "string",
"Page": number,
"Relationships": [
{
"Ids": [ "string" ],
"Type": "string"
}
],
"RowIndex": number,
"RowSpan": number,
"SelectionStatus": "string",
"Text": "string",
"TextType": "string"
}
],
"DetectDocumentTextModelVersion": "string",
"DocumentMetadata": {
"Pages": number
}
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [Blocks](#API_DetectDocumentText_ResponseSyntax) **
의 어레이`Block`문서에서 검색된 텍스트를 포함하는 개체입니다.
Type: 배열[Block](API_Block.md)사물
** [DetectDocumentTextModelVersion](#API_DetectDocumentText_ResponseSyntax) **
Type: String
** [DocumentMetadata](#API_DetectDocumentText_ResponseSyntax) **
문서에 대한 메타데이터입니다. 이 문서에는 문서에서 검색된 페이지 수가 포함됩니다.
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체
## 오류
** AccessDeniedException **
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.
HTTP 상태 코드: 400
** BadDocumentException **
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).
HTTP 상태 코드: 400
** DocumentTooLargeException **
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB입니다. 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.
HTTP 상태 코드: 400
** InternalServerError **
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** 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 Textract에 문의하십시오.
HTTP 상태 코드: 400
** ThrottlingException **
Amazon Textract Textract이 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** UnsupportedDocumentException **
출력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.
HTTP 상태 코드: 400
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/DetectDocumentText)
+ [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/DetectDocumentText)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/DetectDocumentText)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/DetectDocumentText)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/DetectDocumentText)
+ [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/DetectDocumentText)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/DetectDocumentText)
+ [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/DetectDocumentText)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/DetectDocumentText)
# GetDocumentAnalysis
문서의 텍스트를 분석하는 Amazon Textract 비동기 작업의 결과를 가져옵니다.
다음을 호출하여 비동기 텍스트 분석을 시작합니다.[StartDocumentAnalysis](API_StartDocumentAnalysis.md)를 반환하는 작업 식별자 (`JobId`). 텍스트 분석 작업이 완료되면 Amazon Textract Textract는 초기 호출에 등록된 Amazon Simple Notification Service (Amazon SNS) 주제에 완료 상태를 게시합니다.`StartDocumentAnalysis`. 텍스트 감지 작업의 결과를 얻으려면 먼저 Amazon SNS 주제에 게시된 상태 값이 다음과 같은지 확인하십시오.`SUCCEEDED`. 그렇다면 전화하십시오.`GetDocumentAnalysis`작업 식별자를 전달하고 (`JobId`) 초기 통화부터`StartDocumentAnalysis`.
`GetDocumentAnalysis`의 배열을 반환합니다.[Block](API_Block.md)객체. 다음 정보 유형이 반환됩니다.
+ 양식 데이터 (키-값 쌍). 관련 정보는 2개로 반환됩니다.[Block](API_Block.md)객체, 각 유형`KEY_VALUE_SET`: 키`Block`객체 및 값`Block`객체. 예,*이름: 아나 실바 캐롤라이나*에는 키와 값이 포함되어 있습니다. *이름:*열쇠입니다. *아나 실바 캐롤라이나*이 값입니다.
+ 테이블 및 테이블 셀 데이터입니다. 테이블`Block`객체에는 탐지된 테이블에 대한 정보가 들어 있습니다. 셀`Block`테이블의 각 셀에 대해 객체가 반환됩니다.
+ 줄 및 텍스트 단어. 줄 바꿈`Block`객체가 하나 이상의 WORD가 포함되어 있습니다.`Block`객체. 문서에서 감지된 모든 줄과 단어가 반환됩니다 (텍스트 포함).`StartDocumentAnalysis` `FeatureTypes`입력 매개 변수).
확인란 및 옵션 버튼 (라디오 버튼) 과 같은 선택 요소는 양식 데이터 및 테이블에서 감지할 수 있습니다. 셀렉션\$1엘리먼트`Block`객체에는 선택 상태를 포함하여 선택 요소에 대한 정보가 들어 있습니다.
사용`MaxResults`파라미터를 사용하여 반환되는 블록 수를 제한합니다. 에 지정된 것보다 많은 결과가 있는 경우`MaxResults`, 의 가치`NextToken`작업 응답에는 다음 결과 집합을 가져오기 위한 페이지 지정 토큰이 포함되어 있습니다. 결과의 다음 페이지를 가져오려면`GetDocumentAnalysis`를 채우고`NextToken`이전 호출에서 반환된 토큰 값이 있는 요청 매개 변수`GetDocumentAnalysis`.
자세한 내용은 단원을 참조하십시오.[문서 텍스트 분석](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html).
## 요청 구문
```
{
"JobId": "string",
"MaxResults": number,
"NextToken": "string"
}
```
## 요청 파라미터
요청은 JSON 형식의 다음 데이터를 받습니다.
** [JobId](#API_GetDocumentAnalysis_RequestSyntax) **
텍스트 감지 작업의 고유 식별자입니다. 이`JobId`에서 반환됩니다.`StartDocumentAnalysis`. A`JobId`값은 7일 동안만 유효합니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `^[a-zA-Z0-9-_]+$`
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** [MaxResults](#API_GetDocumentAnalysis_RequestSyntax) **
페이지가 지정된 호출당 반환할 최대 결과 수입니다. 지정할 수 있는 가장 큰 값은 1,000입니다. 1,000보다 큰 값을 지정한 경우 최대 1,000개의 결과가 반환됩니다. 기본값은 1000입니다.
Type: 정수
유효 범위: 최소값 1.
: 필수 아니요
** [NextToken](#API_GetDocumentAnalysis_RequestSyntax) **
이전 응답이 불완전한 경우 (검색할 블록이 더 많기 때문에) Amazon Textract Textract는 응답에 페이지 매김 토큰을 반환합니다. 이 페이지 매김 토큰을 사용하여 다음 블록 세트를 검색할 수 있습니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.
Pattern: `.*\S.*`
: 필수 아니요
## 응답 구문
```
{
"AnalyzeDocumentModelVersion": "string",
"Blocks": [
{
"BlockType": "string",
"ColumnIndex": number,
"ColumnSpan": number,
"Confidence": number,
"EntityTypes": [ "string" ],
"Geometry": {
"BoundingBox": {
"Height": number,
"Left": number,
"Top": number,
"Width": number
},
"Polygon": [
{
"X": number,
"Y": number
}
]
},
"Id": "string",
"Page": number,
"Relationships": [
{
"Ids": [ "string" ],
"Type": "string"
}
],
"RowIndex": number,
"RowSpan": number,
"SelectionStatus": "string",
"Text": "string",
"TextType": "string"
}
],
"DocumentMetadata": {
"Pages": number
},
"JobStatus": "string",
"NextToken": "string",
"StatusMessage": "string",
"Warnings": [
{
"ErrorCode": "string",
"Pages": [ number ]
}
]
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [AnalyzeDocumentModelVersion](#API_GetDocumentAnalysis_ResponseSyntax) **
Type: String
** [Blocks](#API_GetDocumentAnalysis_ResponseSyntax) **
텍스트 분석 작업의 결과입니다.
Type: 배열[Block](API_Block.md)사물
** [DocumentMetadata](#API_GetDocumentAnalysis_ResponseSyntax) **
Amazon Textract Textract가 처리한 문서에 대한 정보입니다.`DocumentMetadata`는 Amazon Textract 비디오 작업에서 페이지 매겨진 응답의 모든 페이지에서 반환됩니다.
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체
** [JobStatus](#API_GetDocumentAnalysis_ResponseSyntax) **
텍스트 검색 작업의 현재 상태입니다.
Type: String
유효한 값:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS`
** [NextToken](#API_GetDocumentAnalysis_ResponseSyntax) **
응답이 잘린 경우 Amazon Textract Textract는 이 토큰을 반환합니다. 이 토큰을 후속 요청에서 사용하여 다음 텍스트 검색 결과 집합을 가져올 수 있습니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.
Pattern: `.*\S.*`
** [StatusMessage](#API_GetDocumentAnalysis_ResponseSyntax) **
검색 작업을 완료할 수 없는 경우 반환합니다. 발생한 오류에 대한 설명이 들어 있습니다.
Type: String
** [Warnings](#API_GetDocumentAnalysis_ResponseSyntax) **
문서 분석 작업 중에 발생한 경고 목록입니다.
Type: 배열[Warning](API_Warning.md)사물
## 오류
** AccessDeniedException **
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.
HTTP 상태 코드: 400
** InternalServerError **
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** InvalidJobIdException **
잘못된 작업 식별자가 에 전달되었습니다.[GetDocumentAnalysis](#API_GetDocumentAnalysis)또는[GetDocumentAnalysis](#API_GetDocumentAnalysis).
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 Textract에 문의하십시오.
HTTP 상태 코드: 400
** ThrottlingException **
Amazon Textract 이 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetDocumentAnalysis)
+ [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetDocumentAnalysis)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetDocumentAnalysis)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetDocumentAnalysis)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetDocumentAnalysis)
+ [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetDocumentAnalysis)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetDocumentAnalysis)
+ [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetDocumentAnalysis)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetDocumentAnalysis)
# GetDocumentTextDetection
문서에서 텍스트를 감지하는 Amazon Textract 비동기 작업에 대한 결과를 가져옵니다. Amazon Textract Textract는 텍스트 줄과 텍스트 한 줄을 구성하는 단어를 감지할 수 있습니다.
를 호출하여 비동기 텍스트 감지를 시작합니다.[StartDocumentTextDetection](API_StartDocumentTextDetection.md)를 반환하는 작업 식별자 (`JobId`). 텍스트 검색 작업이 완료되면 Amazon Textract Textract는 초기 호출에 등록된 Amazon Simple Notification Service (Amazon SNS) 주제에 완료 상태를 게시합니다.`StartDocumentTextDetection`. 텍스트 감지 작업의 결과를 얻으려면 먼저 Amazon SNS 주제에 게시된 상태 값이 다음과 같은지 확인하십시오.`SUCCEEDED`. 그렇다면 전화하십시오.`GetDocumentTextDetection`작업 식별자를 전달하고 (`JobId`) 초기 통화부터`StartDocumentTextDetection`.
`GetDocumentTextDetection`의 배열을 반환합니다.[Block](API_Block.md)객체.
각 문서 페이지는 연결된 상태로`Block`페이지 유형입니다. 각 페이지`Block`객체가 LINE에 있는 상위`Block`페이지에서 감지된 텍스트 행을 나타내는 개체입니다. 줄 바꿈`Block`object는 선을 구성하는 각 단어의 부모입니다. 단어는 다음과 같이 표시됩니다.`Block`WORD 유형의 객체입니다.
MaxResulent 파라미터를 사용하여 반환되는 블록 수를 제한합니다. 에 지정된 것보다 많은 결과가 있는 경우`MaxResults`, 의 가치`NextToken`작업 응답에 다음 결과 집합을 가져오기 위한 페이지 매김 토큰이 포함되어 있습니다. 결과의 다음 페이지를 가져오려면`GetDocumentTextDetection`를 채우고`NextToken`이전 호출에서 반환된 토큰 값이 있는 요청 매개 변수`GetDocumentTextDetection`.
자세한 내용은 단원을 참조하십시오.[문서 텍스트 감지](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html).
## 요청 구문
```
{
"JobId": "string",
"MaxResults": number,
"NextToken": "string"
}
```
## 요청 파라미터
요청은 JSON 형식의 다음 데이터를 받습니다.
** [JobId](#API_GetDocumentTextDetection_RequestSyntax) **
텍스트 감지 작업의 고유 식별자입니다. 이`JobId`에서 반환됩니다.`StartDocumentTextDetection`. A`JobId`값은 7일 동안만 유효합니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `^[a-zA-Z0-9-_]+$`
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** [MaxResults](#API_GetDocumentTextDetection_RequestSyntax) **
페이지가 지정된 호출당 반환할 결과의 최대 수입니다. 지정할 수 있는 가장 큰 값은 1,000입니다. 1,000보다 큰 값을 지정한 경우 최대 1,000개의 결과가 반환됩니다. 기본값은 1000입니다.
Type: 정수
유효 범위: 최소값 1.
: 필수 아니요
** [NextToken](#API_GetDocumentTextDetection_RequestSyntax) **
이전 응답이 불완전한 경우 (검색할 블록이 더 많기 때문에) Amazon Textract Textract는 응답에 페이지 매김 토큰을 반환합니다. 이 페이지 매김 토큰을 사용하여 다음 블록 세트를 검색할 수 있습니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.
Pattern: `.*\S.*`
: 필수 아니요
## 응답 구문
```
{
"Blocks": [
{
"BlockType": "string",
"ColumnIndex": number,
"ColumnSpan": number,
"Confidence": number,
"EntityTypes": [ "string" ],
"Geometry": {
"BoundingBox": {
"Height": number,
"Left": number,
"Top": number,
"Width": number
},
"Polygon": [
{
"X": number,
"Y": number
}
]
},
"Id": "string",
"Page": number,
"Relationships": [
{
"Ids": [ "string" ],
"Type": "string"
}
],
"RowIndex": number,
"RowSpan": number,
"SelectionStatus": "string",
"Text": "string",
"TextType": "string"
}
],
"DetectDocumentTextModelVersion": "string",
"DocumentMetadata": {
"Pages": number
},
"JobStatus": "string",
"NextToken": "string",
"StatusMessage": "string",
"Warnings": [
{
"ErrorCode": "string",
"Pages": [ number ]
}
]
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [Blocks](#API_GetDocumentTextDetection_ResponseSyntax) **
텍스트 감지 작업의 결과입니다.
Type: 배열[Block](API_Block.md)사물
** [DetectDocumentTextModelVersion](#API_GetDocumentTextDetection_ResponseSyntax) **
Type: String
** [DocumentMetadata](#API_GetDocumentTextDetection_ResponseSyntax) **
Amazon Textract Textract가 처리한 문서에 대한 정보입니다.`DocumentMetadata`는 Amazon Textract 비디오 작업에서 페이지 매겨진 응답의 모든 페이지에서 반환됩니다.
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체
** [JobStatus](#API_GetDocumentTextDetection_ResponseSyntax) **
텍스트 검색 작업의 현재 상태입니다.
Type: String
유효한 값:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS`
** [NextToken](#API_GetDocumentTextDetection_ResponseSyntax) **
응답이 잘린 경우 Amazon Textract Textract는 이 토큰을 반환합니다. 후속 요청에서 이 토큰을 사용하여 다음 텍스트 감지 결과 집합을 가져올 수 있습니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.
Pattern: `.*\S.*`
** [StatusMessage](#API_GetDocumentTextDetection_ResponseSyntax) **
검색 작업을 완료할 수 없는 경우 반환합니다. 발생한 오류에 대한 설명이 들어 있습니다.
Type: String
** [Warnings](#API_GetDocumentTextDetection_ResponseSyntax) **
문서에 대한 텍스트 감지 작업 중에 발생한 경고 목록입니다.
Type: 배열[Warning](API_Warning.md)사물
## 오류
** AccessDeniedException **
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.
HTTP 상태 코드: 400
** InternalServerError **
Amazon Textract 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 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 Textract에 문의하십시오.
HTTP 상태 코드: 400
** ThrottlingException **
Amazon Textract Textract이 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetDocumentTextDetection)
+ [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetDocumentTextDetection)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetDocumentTextDetection)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetDocumentTextDetection)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetDocumentTextDetection)
+ [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetDocumentTextDetection)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetDocumentTextDetection)
+ [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetDocumentTextDetection)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetDocumentTextDetection)
# GetExpenseAnalysis
송장 및 영수증을 분석하는 Amazon Textract 비동기 작업에 대한 결과를 가져옵니다. Amazon Textract Textract는 입력 송장 및 영수증에서 연락처 정보, 구매한 품목 및 공급업체 이름을 찾습니다.
다음을 호출하여 비동기 인보이스/영수증 분석을 시작합니다.[StartExpenseAnalysis](API_StartExpenseAnalysis.md)를 반환하는 작업 식별자 (`JobId`). Amazon Textract는 송장/영수증 분석이 완료되면 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`. A`JobId`값은 7일 동안만 유효합니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `^[a-zA-Z0-9-_]+$`
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** [MaxResults](#API_GetExpenseAnalysis_RequestSyntax) **
페이지가 지정된 호출당 반환할 결과의 최대 수입니다. 지정할 수 있는 가장 큰 값은 20입니다. 20보다 큰 값을 지정한 경우 최대 20개의 결과가 반환됩니다. 기본값은 20입니다.
Type: 정수
유효 범위: 최소값은 1이고,
: 필수 아니요
** [NextToken](#API_GetExpenseAnalysis_RequestSyntax) **
이전 응답이 불완전한 경우 (검색할 블록이 더 많기 때문에) Amazon Textract Textract는 응답에 페이지 매김 토큰을 반환합니다. 이 페이지 매김 토큰을 사용하여 다음 블록 세트를 검색할 수 있습니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.
Pattern: `.*\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) **
분석의 현재 모델 버전입니다.
Type: String
** [DocumentMetadata](#API_GetExpenseAnalysis_ResponseSyntax) **
Amazon Textract Textract가 처리한 문서에 대한 정보입니다.`DocumentMetadata`는 Amazon Textract 작업에서 페이지 매겨진 응답의 모든 페이지에서 반환됩니다.
유형: [DocumentMetadata](API_DocumentMetadata.md) 객체
** [ExpenseDocuments](#API_GetExpenseAnalysis_ResponseSyntax) **
Amazon Textract Textract에서 감지한 비용입니다.
Type: 배열[ExpenseDocument](API_ExpenseDocument.md)사물
** [JobStatus](#API_GetExpenseAnalysis_ResponseSyntax) **
텍스트 검색 작업의 현재 상태입니다.
Type: String
유효한 값:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS`
** [NextToken](#API_GetExpenseAnalysis_ResponseSyntax) **
응답이 잘린 경우 Amazon Textract Textract는 이 토큰을 반환합니다. 이 토큰을 후속 요청에서 사용하여 다음 텍스트 검색 결과 집합을 가져올 수 있습니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 255.
Pattern: `.*\S.*`
** [StatusMessage](#API_GetExpenseAnalysis_ResponseSyntax) **
검색 작업을 완료할 수 없는 경우 반환합니다. 발생한 오류에 대한 설명이 들어 있습니다.
Type: String
** [Warnings](#API_GetExpenseAnalysis_ResponseSyntax) **
문서에 대한 텍스트 감지 작업 중에 발생한 경고 목록입니다.
Type: 배열[Warning](API_Warning.md)사물
## 오류
** AccessDeniedException **
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.
HTTP 상태 코드: 400
** InternalServerError **
Amazon Textract 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 Textract에 문의하십시오.
HTTP 상태 코드: 400
** ThrottlingException **
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [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)
+ [AWSPython용 SDK](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)
# StartDocumentAnalysis
키-값 페어, 테이블 및 선택 요소와 같은 감지된 항목 간의 관계에 대한 입력 문서의 비동기식 분석을 시작합니다.
`StartDocumentAnalysis`에서는 JPEG, PNG, TIFF 및 PDF 형식의 문서에서 텍스트를 분석할 수 있습니다. Amazon S3 버킷에 저장됩니다. 사용[DocumentLocation](API_DocumentLocation.md)을 눌러 문서의 버킷 이름과 파일 이름을 지정합니다.
`StartDocumentAnalysis`작업 식별자를 반환합니다 (`JobId`) 을 사용하여 작업 결과를 얻습니다. 텍스트 분석이 완료되면 Amazon Textract Textract가 에서 지정한 Amazon Simple Notification Service (Amazon SNS) 주제에 완료 상태를 게시합니다.`NotificationChannel`. 텍스트 분석 작업의 결과를 얻으려면 먼저 Amazon SNS 주제에 게시된 상태 값이 다음과 같은지 확인하십시오.`SUCCEEDED`. 그렇다면 전화하십시오.[GetDocumentAnalysis](API_GetDocumentAnalysis.md)작업 식별자를 전달하고 (`JobId`) 초기 통화부터`StartDocumentAnalysis`.
자세한 내용은 단원을 참조하십시오.[문서 텍스트 분석](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html).
## 요청 구문
```
{
"ClientRequestToken": "string",
"DocumentLocation": {
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
},
"FeatureTypes": [ "string" ],
"JobTag": "string",
"KMSKeyId": "string",
"NotificationChannel": {
"RoleArn": "string",
"SNSTopicArn": "string"
},
"OutputConfig": {
"S3Bucket": "string",
"S3Prefix": "string"
}
}
```
## 요청 파라미터
요청은 JSON 형식의 다음 데이터를 받습니다.
** [ClientRequestToken](#API_StartDocumentAnalysis_RequestSyntax) **
시작 요청을 식별하는 데 사용하는 멱등성 토큰입니다. 동일한 토큰을 여러 개 사용하여 사용하는 경우`StartDocumentAnalysis`요청, 동일`JobId`이 반환됩니다. 사용`ClientRequestToken`같은 작업이 실수로 두 번 이상 시작되지 않도록 합니다. 자세한 내용은 단원을 참조하십시오.[Amazon Textract 비동기 작업 호출](https://docs.aws.amazon.com/textract/latest/dg/api-async.html).
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `^[a-zA-Z0-9-_]+$`
: 필수 아니요
** [DocumentLocation](#API_StartDocumentAnalysis_RequestSyntax) **
처리할 문서의 위치입니다.
유형: [DocumentLocation](API_DocumentLocation.md) 객체
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** [FeatureTypes](#API_StartDocumentAnalysis_RequestSyntax) **
수행할 분석 유형의 목록입니다. 목록에 TABLES를 추가하여 입력 문서에서 검색된 테이블에 대한 정보를 반환합니다. FORMS를 추가하여 검색된 양식 데이터를 반환합니다. 두 가지 유형의 분석을 모두 수행하려면 TABLES 및 FORMS를`FeatureTypes`. 문서에서 감지된 모든 줄과 단어가 응답에 포함됩니다 (값과 관련이 없는 텍스트 포함)`FeatureTypes`).
Type: 문자열 배열
유효한 값:` TABLES | FORMS`
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** [JobTag](#API_StartDocumentAnalysis_RequestSyntax) **
지정한 식별자로, Amazon SNS 주제에 게시된 완료 알림에 포함됩니다. 예를 들어 를 사용할 수 있습니다.`JobTag`완료 통지가 해당하는 문서 유형 (예: 세금 양식 또는 영수증) 을 식별합니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `[a-zA-Z0-9_.\-:]+`
: 필수 아니요
** [KMSKeyId](#API_StartDocumentAnalysis_RequestSyntax) **
추론 결과를 암호화하는 데 사용되는 KMS 키입니다. 키 ID 또는 키 별칭 형식일 수 있습니다. KMS 키가 제공되면 고객 버킷에 있는 객체의 서버 측 암호화에 KMS 키가 사용됩니다. 이 매개 변수를 활성화하지 않으면 결과는 SSE-S3 를 사용하여 서버 측에서 암호화됩니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 2048.
Pattern: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$`
: 필수 아니요
** [NotificationChannel](#API_StartDocumentAnalysis_RequestSyntax) **
Amazon Textract가 작업의 완료 상태를 게시하도록 하려는 Amazon SNS 주제 ARN입니다.
유형: [NotificationChannel](API_NotificationChannel.md) 객체
: 필수 아니요
** [OutputConfig](#API_StartDocumentAnalysis_RequestSyntax) **
출력이 고객 정의 버킷으로 이동할지 여부를 설정합니다. 기본적으로 Amazon Textract Textract는 GetDocumentAnalysis 작업에서 액세스할 수 있도록 결과를 내부적으로 저장합니다.
유형: [OutputConfig](API_OutputConfig.md) 객체
: 필수 아니요
## 응답 구문
```
{
"JobId": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [JobId](#API_StartDocumentAnalysis_ResponseSyntax) **
문서 텍스트 감지 작업의 식별자입니다. 사용`JobId`후속 호출에서 작업을 식별합니다.`GetDocumentAnalysis`. A`JobId`값은 7일 동안만 유효합니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `^[a-zA-Z0-9-_]+$`
## 오류
** AccessDeniedException **
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.
HTTP 상태 코드: 400
** BadDocumentException **
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).
HTTP 상태 코드: 400
** DocumentTooLargeException **
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.
HTTP 상태 코드: 400
** IdempotentParameterMismatchException **
A`ClientRequestToken`input 파라미터가 작업과 함께 재사용되었지만 하나 이상의 다른 입력 파라미터가 이전의 작업 호출과 다릅니다.
HTTP 상태 코드: 400
** InternalServerError **
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** InvalidKMSKeyException **
KMS 키를 입력한 상태에서 암호 해독 권한이 없거나 KMS 키가 잘못 입력되었음을 나타냅니다.
HTTP 상태 코드: 400
** InvalidParameterException **
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음 위치에 제공됩니다.`Document`요청 파라미터입니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.
HTTP 상태 코드: 400
** InvalidS3ObjectException **
Amazon Textract 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
** LimitExceededException **
Amazon Textract 서비스 제한을 초과했습니다. 예를 들어 너무 많은 비동기 작업을 동시에 시작하는 경우 시작 작업을 호출합니다 (`StartDocumentTextDetection`예를 들어) 을 발생시키면 동시 실행 작업의 수가 Amazon Textract 서비스 제한 미만이 될 때까지 (HTTP 상태 코드: 400) 이 발생합니다.
HTTP 상태 코드: 400
** ProvisionedThroughputExceededException **
요청의 수가 처리량 한도를 초과했습니다. 이 한도를 늘려야 하는 경우 Amazon Textract Textract에 문의하십시오.
HTTP 상태 코드: 400
** ThrottlingException **
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** UnsupportedDocumentException **
출력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.
HTTP 상태 코드: 400
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartDocumentAnalysis)
+ [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartDocumentAnalysis)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartDocumentAnalysis)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartDocumentAnalysis)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartDocumentAnalysis)
+ [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartDocumentAnalysis)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartDocumentAnalysis)
+ [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartDocumentAnalysis)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartDocumentAnalysis)
# StartDocumentTextDetection
문서에서 텍스트의 비동기 감지를 시작합니다. Amazon Textract Textract는 텍스트 줄과 텍스트 한 줄을 구성하는 단어를 감지할 수 있습니다.
`StartDocumentTextDetection`에서는 JPEG, PNG, TIFF 및 PDF 형식의 문서에서 텍스트를 분석할 수 있습니다. 문서는 Amazon S3 버킷에 저장됩니다. 사용[DocumentLocation](API_DocumentLocation.md)을 눌러 문서의 버킷 이름과 파일 이름을 지정합니다.
`StartTextDetection`작업 식별자를 반환합니다 (`JobId`) 을 사용하여 작업 결과를 얻습니다. 텍스트 감지가 완료되면 Amazon Textract Textract가 에서 지정한 Amazon Simple Notification Service (Amazon SNS) 주제에 완료 상태를 게시합니다.`NotificationChannel`. 텍스트 감지 작업의 결과를 얻으려면 먼저 Amazon SNS 주제에 게시된 상태 값이 다음과 같은지 확인하십시오.`SUCCEEDED`. 그렇다면 전화하십시오.[GetDocumentTextDetection](API_GetDocumentTextDetection.md)작업 식별자를 전달하고 (`JobId`) 초기 호출부터`StartDocumentTextDetection`.
자세한 내용은 단원을 참조하십시오.[문서 텍스트 감지](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html).
## 요청 구문
```
{
"ClientRequestToken": "string",
"DocumentLocation": {
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
},
"JobTag": "string",
"KMSKeyId": "string",
"NotificationChannel": {
"RoleArn": "string",
"SNSTopicArn": "string"
},
"OutputConfig": {
"S3Bucket": "string",
"S3Prefix": "string"
}
}
```
## 요청 파라미터
요청은 JSON 형식의 다음 데이터를 받습니다.
** [ClientRequestToken](#API_StartDocumentTextDetection_RequestSyntax) **
시작 요청을 식별하는 데 사용되는 멱등 토큰입니다. 동일한 토큰을 여러 개 사용하여 사용하는 경우`StartDocumentTextDetection`요청, 동일`JobId`이 반환됩니다. 사용`ClientRequestToken`같은 작업이 실수로 두 번 이상 시작되지 않도록 합니다. 자세한 내용은 단원을 참조하십시오.[Amazon Textract 비동기 작업 호출](https://docs.aws.amazon.com/textract/latest/dg/api-async.html).
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `^[a-zA-Z0-9-_]+$`
: 필수 아니요
** [DocumentLocation](#API_StartDocumentTextDetection_RequestSyntax) **
처리할 문서의 위치입니다.
유형: [DocumentLocation](API_DocumentLocation.md) 객체
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** [JobTag](#API_StartDocumentTextDetection_RequestSyntax) **
지정한 식별자로, Amazon SNS 주제에 게시된 완료 알림에 포함됩니다. 예를 들어 를 사용할 수 있습니다.`JobTag`완료 통지가 해당하는 문서 유형 (예: 세금 양식 또는 영수증) 을 식별합니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `[a-zA-Z0-9_.\-:]+`
: 필수 아니요
** [KMSKeyId](#API_StartDocumentTextDetection_RequestSyntax) **
추론 결과를 암호화하는 데 사용되는 KMS 키입니다. 키 ID 또는 키 별칭 형식일 수 있습니다. KMS 키가 제공되면 고객 버킷에 있는 객체의 서버 측 암호화에 KMS 키가 사용됩니다. 이 매개 변수를 활성화하지 않으면 결과는 SSE-S3 를 사용하여 서버 측에서 암호화됩니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 2048.
Pattern: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$`
: 필수 아니요
** [NotificationChannel](#API_StartDocumentTextDetection_RequestSyntax) **
Amazon Textract가 작업의 완료 상태를 게시하도록 하려는 Amazon SNS 주제 ARN입니다.
유형: [NotificationChannel](API_NotificationChannel.md) 객체
: 필수 아니요
** [OutputConfig](#API_StartDocumentTextDetection_RequestSyntax) **
출력이 고객 정의 버킷으로 이동할지 여부를 설정합니다. 기본적으로 Amazon Textract Textract는 GetDocumentTextDetection 작업을 통해 액세스할 수 있도록 결과를 내부적으로 저장합니다.
유형: [OutputConfig](API_OutputConfig.md) 객체
: 필수 아니요
## 응답 구문
```
{
"JobId": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [JobId](#API_StartDocumentTextDetection_ResponseSyntax) **
문서에 대한 텍스트 검색 작업의 식별자입니다. 사용`JobId`후속 호출에서 작업을 식별합니다.`GetDocumentTextDetection`. A`JobId`값은 7일 동안만 유효합니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `^[a-zA-Z0-9-_]+$`
## 오류
** AccessDeniedException **
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.
HTTP 상태 코드: 400
** BadDocumentException **
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).
HTTP 상태 코드: 400
** DocumentTooLargeException **
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기 10MB. 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.
HTTP 상태 코드: 400
** IdempotentParameterMismatchException **
A`ClientRequestToken`입력 파라미터가 작업에서 재사용되었지만 하나 이상의 다른 입력 파라미터가 이전의 작업 호출과 다릅니다.
HTTP 상태 코드: 400
** InternalServerError **
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** InvalidKMSKeyException **
KMS 키를 입력한 상태에서 암호 해독 권한이 없거나 KMS 키가 잘못 입력되었음을 나타냅니다.
HTTP 상태 코드: 400
** InvalidParameterException **
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음 위치에 제공됩니다.`Document`요청 파라미터입니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.
HTTP 상태 코드: 400
** InvalidS3ObjectException **
Amazon Textract 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
** LimitExceededException **
Amazon Textract Service 제한을 초과했습니다. 예를 들어 너무 많은 비동기 작업을 동시에 시작하면 시작 작업을 호출합니다 (`StartDocumentTextDetection`예를 들어) 을 발생시킬 경우에는 동시 실행 작업의 수가 Amazon Textract Service 제한 미만이 될 때까지 제한 Excepeption 예외 (HTTP 상태 코드: 400) 가 발생합니다.
HTTP 상태 코드: 400
** ProvisionedThroughputExceededException **
요청의 수가 처리량 한도를 초과했습니다. 이 한도를 늘려야 하는 경우 Amazon Textract Textract에 문의하십시오.
HTTP 상태 코드: 400
** ThrottlingException **
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** UnsupportedDocumentException **
입력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.
HTTP 상태 코드: 400
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartDocumentTextDetection)
+ [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartDocumentTextDetection)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartDocumentTextDetection)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartDocumentTextDetection)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartDocumentTextDetection)
+ [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartDocumentTextDetection)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartDocumentTextDetection)
+ [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartDocumentTextDetection)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartDocumentTextDetection)
# StartExpenseAnalysis
연락처 정보, 구매한 항목 및 공급업체 이름과 같은 데이터에 대한 송장 또는 영수증의 비동기 분석을 시작합니다.
`StartExpenseAnalysis`에서는 JPEG, PNG 및 PDF 형식의 문서에서 텍스트를 분석할 수 있습니다. 문서는 Amazon S3 버킷에 저장되어야 합니다. 사용[DocumentLocation](API_DocumentLocation.md)파라미터를 사용하여 S3 버킷 이름과 해당 버킷에 있는 문서의 이름을 지정합니다.
`StartExpenseAnalysis`작업 식별자를 반환합니다 (`JobId`) 귀하가 제공할 것`GetExpenseAnalysis`을 사용하여 작업 결과를 검색합니다. 입력 송장/영수증 분석이 완료되면 Amazon Textract Textract는 완료 상태를 셀러가 제공하는 아마존 Simple Notification Service (Amazon SNS) 주제에 게시합니다.`NotificationChannel`. 송장 및 영수증 분석 작업의 결과를 얻으려면 Amazon SNS 주제에 게시된 상태 값이 다음과 같은지 확인하십시오.`SUCCEEDED`. 그렇다면 전화하십시오.[GetExpenseAnalysis](API_GetExpenseAnalysis.md)작업 식별자를 전달하고 (`JobId`) 귀하의 전화가 반환되었습니다.`StartExpenseAnalysis`.
자세한 내용은 단원을 참조하십시오.[송장 및 수금 분석](https://docs.aws.amazon.com/textract/latest/dg/invoice-receipts.html).
## 요청 구문
```
{
"ClientRequestToken": "string",
"DocumentLocation": {
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
},
"JobTag": "string",
"KMSKeyId": "string",
"NotificationChannel": {
"RoleArn": "string",
"SNSTopicArn": "string"
},
"OutputConfig": {
"S3Bucket": "string",
"S3Prefix": "string"
}
}
```
## 요청 파라미터
요청은 JSON 형식의 다음 데이터를 받습니다.
** [ClientRequestToken](#API_StartExpenseAnalysis_RequestSyntax) **
시작 요청을 식별하는 데 사용되는 멱등성 토큰입니다. 동일한 토큰을 여러 개 사용하여 사용하는 경우`StartDocumentTextDetection`요청, 동일`JobId`가 반환됩니다. 사용`ClientRequestToken`같은 작업이 실수로 두 번 이상 시작되지 않도록 합니다. 자세한 내용은 단원을 참조하십시오.[Amazon Textract 비동기 작업 호출](https://docs.aws.amazon.com/textract/latest/dg/api-async.html)
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `^[a-zA-Z0-9-_]+$`
: 필수 아니요
** [DocumentLocation](#API_StartExpenseAnalysis_RequestSyntax) **
처리할 문서의 위치입니다.
유형: [DocumentLocation](API_DocumentLocation.md) 객체
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** [JobTag](#API_StartExpenseAnalysis_RequestSyntax) **
지정한 식별자로, Amazon SNS 주제에 게시된 완료 알림에 포함됩니다. 예를 들어 를 사용할 수 있습니다.`JobTag`완료 통지가 해당하는 문서 유형 (예: 세금 양식 또는 영수증) 을 식별합니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `[a-zA-Z0-9_.\-:]+`
: 필수 아니요
** [KMSKeyId](#API_StartExpenseAnalysis_RequestSyntax) **
추론 결과를 암호화하는 데 사용되는 KMS 키입니다. 키 ID 또는 키 별칭 형식일 수 있습니다. KMS 키가 제공되면 고객 버킷에 있는 객체의 서버 측 암호화에 KMS 키가 사용됩니다. 이 매개 변수를 활성화하지 않으면 결과는 SSE-S3 를 사용하여 서버 측에서 암호화됩니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 2048.
Pattern: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$`
: 필수 아니요
** [NotificationChannel](#API_StartExpenseAnalysis_RequestSyntax) **
Amazon Textract가 작업의 완료 상태를 게시하도록 하려는 Amazon SNS 주제 ARN입니다.
유형: [NotificationChannel](API_NotificationChannel.md) 객체
: 필수 아니요
** [OutputConfig](#API_StartExpenseAnalysis_RequestSyntax) **
출력이 고객 정의 버킷으로 이동할지 여부를 설정합니다. 기본적으로 Amazon Textract Textract는 다음에 액세스할 수 있도록 결과를 내부적으로 저장합니다.`GetExpenseAnalysis`작업.
유형: [OutputConfig](API_OutputConfig.md) 객체
: 필수 아니요
## 응답 구문
```
{
"JobId": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [JobId](#API_StartExpenseAnalysis_ResponseSyntax) **
텍스트 검색 작업의 고유 식별자입니다. 이`JobId`에서 반환됩니다.`StartExpenseAnalysis`. A`JobId`값은 7일 동안만 유효합니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 64.
Pattern: `^[a-zA-Z0-9-_]+$`
## 오류
** AccessDeniedException **
작업을 수행할 권한이 없습니다. 권한 있는 사용자 또는 IAM 역할의 Amazon 리소스 이름(ARN)을 사용하여 작업을 수행하십시오.
HTTP 상태 코드: 400
** BadDocumentException **
Amazon Textract Textract는 문서를 읽을 수 없습니다. Amazon Textract Textract의 문서 한도에 대한 자세한 내용은 단원을 참조하십시오.[Amazon Textract TEXTRACT에서의 하드 제한](limits.md).
HTTP 상태 코드: 400
** DocumentTooLargeException **
문서가 너무 크기 때문에 처리할 수 없습니다. 동기 작업의 최대 문서 크기입니다. 10MB입니다. 비동기 작업의 최대 문서 크기는 PDF 파일의 경우 500MB입니다.
HTTP 상태 코드: 400
** IdempotentParameterMismatchException **
A`ClientRequestToken`입력 파라미터가 작업에서 재사용되었지만 하나 이상의 다른 입력 파라미터가 이전의 작업 호출과 다릅니다.
HTTP 상태 코드: 400
** InternalServerError **
Amazon Textract Textract에 서비스 문제가 발생했습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** InvalidKMSKeyException **
KMS 키를 입력한 상태에서 암호 해독 권한이 없거나 KMS 키가 잘못 입력되었음을 나타냅니다.
HTTP 상태 코드: 400
** InvalidParameterException **
입력 파라미터가 제약 조건을 위반했습니다. 예를 들어, 동기 작업에서는`InvalidParameterException`예외가 발생하지 않을 때`S3Object`또는`Bytes`값은 다음 위치에 제공됩니다.`Document`요청 파라미터를 지정합니다. 파라미터를 확인한 다음 API 작업을 다시 호출하십시오.
HTTP 상태 코드: 400
** InvalidS3ObjectException **
Amazon Textract 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
** LimitExceededException **
Amazon Textract 서비스 한도를 초과했습니다. 예를 들어 너무 많은 비동기 작업을 동시에 시작하면 시작 작업을 호출합니다 (`StartDocumentTextDetection`예를 들어) 을 발생시킬 경우에는 동시 실행 작업의 수가 Amazon Textract 서비스 제한 미만이 될 때까지 예외 (HTTP 상태 코드: 400) 가 발생합니다.
HTTP 상태 코드: 400
** ProvisionedThroughputExceededException **
요청의 수가 처리량 한도를 초과했습니다. 이 한도를 늘려야 하는 경우 Amazon Textract Textract에 문의하십시오.
HTTP 상태 코드: 400
** ThrottlingException **
Amazon Textract Textract가 요청을 일시적으로 처리할 수 없습니다. 호출을 다시 시도하십시오.
HTTP 상태 코드: 500
** UnsupportedDocumentException **
출력 문서의 형식은 지원되지 않습니다. 작업 문서는 PNG, JPEG, PDF 또는 TIFF 형식일 수 있습니다.
HTTP 상태 코드: 400
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartExpenseAnalysis)
+ [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartExpenseAnalysis)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartExpenseAnalysis)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartExpenseAnalysis)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartExpenseAnalysis)
+ [AWS SDK for JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartExpenseAnalysis)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartExpenseAnalysis)
+ [AWSPython용 SDK](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartExpenseAnalysis)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartExpenseAnalysis)
# 데이터 유형
다음 데이터 유형이 지원됩니다.
+ [AnalyzeIDDetections](API_AnalyzeIDDetections.md)
+ [Block](API_Block.md)
+ [BoundingBox](API_BoundingBox.md)
+ [Document](API_Document.md)
+ [DocumentLocation](API_DocumentLocation.md)
+ [DocumentMetadata](API_DocumentMetadata.md)
+ [ExpenseDetection](API_ExpenseDetection.md)
+ [ExpenseDocument](API_ExpenseDocument.md)
+ [ExpenseField](API_ExpenseField.md)
+ [ExpenseType](API_ExpenseType.md)
+ [Geometry](API_Geometry.md)
+ [HumanLoopActivationOutput](API_HumanLoopActivationOutput.md)
+ [HumanLoopConfig](API_HumanLoopConfig.md)
+ [HumanLoopDataAttributes](API_HumanLoopDataAttributes.md)
+ [IdentityDocument](API_IdentityDocument.md)
+ [IdentityDocumentField](API_IdentityDocumentField.md)
+ [LineItemFields](API_LineItemFields.md)
+ [LineItemGroup](API_LineItemGroup.md)
+ [NormalizedValue](API_NormalizedValue.md)
+ [NotificationChannel](API_NotificationChannel.md)
+ [OutputConfig](API_OutputConfig.md)
+ [Point](API_Point.md)
+ [Relationship](API_Relationship.md)
+ [S3Object](API_S3Object.md)
+ [Warning](API_Warning.md)
# AnalyzeIDDetections
AnalyzeID 작업에서 감지된 정보를 포함하는 데 사용됩니다.
## 목차
** Confidence **
감지된 텍스트 의 신뢰 점수입니다.
Type: 부동 소수점
유효한 범위: 최소값 0. 최대 값은 100입니다.
필수 사항: 아니요
** NormalizedValue **
날짜에 대해서만 반환되며, 감지된 값의 유형과 더 기계 읽기 쉬운 방식으로 작성된 날짜를 반환합니다.
유형: [NormalizedValue](API_NormalizedValue.md) 객체
필수 사항: 아니요
** Text **
정규화된 필드 또는 연관된 값의 텍스트입니다.
Type: String
필수 사항: 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeIDDetections)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeIDDetections)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeIDDetections)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeIDDetections)
# Block
A`Block`는 서로 가까운 픽셀 그룹 내의 문서에서 인식되는 항목을 나타냅니다. 에서 반환되는 정보`Block`객체는 작업 유형에 따라 다릅니다. 문서에 대한 텍스트 감지 (예:[DetectDocumentText](API_DetectDocumentText.md)) 를 선택하면 검색된 단어와 텍스트 줄에 대한 정보를 얻을 수 있습니다. 텍스트 분석 (예:[AnalyzeDocument](API_AnalyzeDocument.md)) 을 사용하면 문서에서 검색된 필드, 테이블 및 선택 요소에 대한 정보도 얻을 수 있습니다.
의 어레이`Block`객체는 동기 및 비동기 작업 모두에 의해 반환됩니다. 동기식 작업 (예:[DetectDocumentText](API_DetectDocumentText.md)의 배열`Block`객체는 전체 결과 집합입니다. 비동기 작업 (예:[GetDocumentAnalysis](API_GetDocumentAnalysis.md)를 선택하면 하나 이상의 응답을 통해 배열이 반환됩니다.
자세한 내용은 단원을 참조하십시오.[Amazon Textract 작동 방식](https://docs.aws.amazon.com/textract/latest/dg/how-it-works.html).
## 목차
** BlockType **
인식되는 텍스트 항목의 유형입니다. 텍스트 감지 작업에서 다음 유형이 반환됩니다.
+ *페이지*- LINE 목록이 포함되어 있습니다.`Block`문서 페이지에서 감지된 개체입니다.
+ *단어*- 문서 페이지에서 감지된 단어입니다. 단어는 공백으로 구분되지 않은 하나 이상의 ISO 기본 라틴 스크립트 문자입니다.
+ *선*- 문서 페이지에서 감지되는 탭으로 구분된 연속 단어 문자열입니다.
텍스트 분석 작업에서는 다음 유형이 반환됩니다.
+ *페이지*- 하위 목록이 포함되어 있습니다.`Block`문서 페이지에서 감지된 개체입니다.
+ *키\$1값\$1세트*- 키 및 가치 저장`Block`문서 페이지에서 감지된 링크된 텍스트의 개체입니다. 사용`EntityType`KEY\$1VALUE\$1SET 객체가 키인지 확인하는 필드`Block`객체 또는 값`Block`객체입니다.
+ *단어*- 문서 페이지에서 감지된 단어입니다. 단어는 공백으로 구분되지 않은 하나 이상의 ISO 기본 라틴 스크립트 문자입니다.
+ *선*- 문서 페이지에서 감지되는 탭으로 구분된 연속 단어 문자열입니다.
+ *표*- 문서 페이지에서 감지된 테이블입니다. 테이블은 두 개 이상의 행이나 열이 있는 그리드 기반 정보로, 셀 범위는 한 행과 각각 하나의 열로 구성됩니다.
+ *세포*- 감지된 테이블 내의 셀입니다. 셀은 셀의 텍스트를 포함하는 블록의 상위입니다.
+ *선택\$1요소*- 옵션 버튼 (라디오 버튼) 또는 문서 페이지에서 감지된 확인란과 같은 선택 요소 다음 값을 사용합니다.`SelectionStatus`선택 요소의 상태를 확인할 수 있습니다.
Type: String
유효한 값:` KEY_VALUE_SET | PAGE | LINE | WORD | TABLE | CELL | SELECTION_ELEMENT`
: 필수 아니요
** ColumnIndex **
테이블 셀이 나타나는 열입니다. 첫 번째 열 위치는 1입니다.`ColumnIndex`는 반환되지 않습니다.`DetectDocumentText`과`GetDocumentTextDetection`.
Type: 정수
유효한 범위: 최소값 0.
: 필수 아니요
** ColumnSpan **
테이블 셀이 걸쳐있는 열 수입니다. 현재 이 값은 스팬된 열 수가 1보다 큰 경우에도 항상 1입니다.`ColumnSpan`는 반환되지 않습니다.`DetectDocumentText`과`GetDocumentTextDetection`.
Type: 정수
유효한 범위: 최소값 0.
: 필수 아니요
** Confidence **
인식된 텍스트의 정확도와 인식된 텍스트 주위의 지오메트리 포인트의 정확성에 대해 Amazon Textract Textract의 신뢰도 점수입니다.
Type: 부동 소수점
유효한 범위: 최소값 0. 최대값 100입니다.
: 필수 아니요
** EntityTypes **
엔터티의 유형입니다. 다음을 반환할 수 있습니다.
+ *키*- 문서의 필드에 대한 식별자입니다.
+ *값*- 필드 텍스트입니다.
`EntityTypes`는 반환되지 않습니다.`DetectDocumentText`과`GetDocumentTextDetection`.
Type: 문자열 배열
유효한 값:` KEY | VALUE`
: 필수 아니요
** Geometry **
이미지에서 인식된 텍스트의 위치입니다. 여기에는 텍스트를 둘러싸는 축 정렬된 거친 경계 상자와 보다 정확한 공간 정보를 위한 미세한 다각형이 포함되어 있습니다.
유형: [Geometry](API_Geometry.md) 객체
: 필수 아니요
** Id **
인식된 텍스트의 식별자입니다. 식별자는 단일 작업에 대해서만 고유합니다.
Type: String
Pattern: `.*\S.*`
: 필수 아니요
** Page **
블록이 감지된 페이지입니다.`Page`는 비동기 작업에 의해 반환됩니다. 1보다 큰 페이지 값은 PDF 또는 TIFF 형식의 여러 페이지 문서에 대해서만 반환됩니다. 스캔한 이미지 (JPEG/PNG) 는 여러 문서 페이지가 포함되어 있더라도 단일 페이지 문서로 간주됩니다. 의 가치`Page`는 항상 1입니다. 동기식 작업이 반환되지 않음`Page`모든 입력 문서는 단일 페이지 문서로 간주되기 때문입니다.
Type: 정수
유효한 범위: 최소값 0.
: 필수 아니요
** Relationships **
현재 블록의 하위 블록 목록입니다. 예를 들어 LINE 객체에는 텍스트 줄의 일부인 각 WORD 블록에 대한 하위 블록이 있습니다. 현재 블록에 하위 블록이 없는 경우와 같이 존재하지 않는 관계에 대한 관계 객체가 목록에 없습니다. 목록 크기는 다음과 같습니다.
+ 0 - 블록에 하위 블록이 없습니다.
+ 1 - 블록에 하위 블록이 있습니다.
Type: 배열[Relationship](API_Relationship.md)사물
: 필수 아니요
** RowIndex **
테이블 셀이 있는 행입니다. 첫 번째 행 위치는 1입니다.`RowIndex`는 반환되지 않습니다.`DetectDocumentText`과`GetDocumentTextDetection`.
Type: 정수
유효한 범위: 최소값 0.
: 필수 아니요
** RowSpan **
테이블 셀의 행 수입니다. 현재 이 값은 스팬된 행 수가 1보다 크더라도 항상 1입니다.`RowSpan`는 반환되지 않습니다.`DetectDocumentText`과`GetDocumentTextDetection`.
Type: 정수
유효한 범위: 최소값 0.
: 필수 아니요
** SelectionStatus **
옵션 버튼이나 확인란과 같은 선택 요소의 선택 상태입니다.
Type: String
유효한 값:` SELECTED | NOT_SELECTED`
: 필수 아니요
** Text **
Amazon Textract Textract에서 인식하는 단어 또는 텍스트 행입니다.
Type: String
: 필수 아니요
** TextType **
Amazon Textract Textract가 감지한 텍스트의 종류입니다. 필기 텍스트와 인쇄된 텍스트를 확인할 수 있습니다.
Type: String
유효한 값:` HANDWRITING | PRINTED`
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Block)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Block)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Block)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Block)
# BoundingBox
검색된 페이지, 텍스트, 키-값 쌍, 표, 표 셀 또는 문서 페이지의 선택 요소 주위의 경계 상자입니다. 이`left`(x-좌표) 및`top`(y 좌표) 는 경계 상자의 상단 및 왼쪽을 나타내는 좌표입니다. 이미지의 좌측 상단 모서리는 원점 (0,0) 입니다.
이`top`과`left`반환되는 값은 전체 문서 페이지 크기의 비율입니다. 예를 들어 입력 이미지가 700x200픽셀이고, 경계 상자의 상단-좌측 좌표가 350x50픽셀일 경우 API는 `left` 값 0.5(350/700)와 `top` 값 0.25(50/200)를 반환합니다.
이`width`과`height`값은 전체 문서 페이지 차원에 대한 비율로서 경계 상자의 크기를 나타냅니다. 예를 들어 문서 페이지 크기가 700 x 200픽셀이고 테두리 상자 너비가 70픽셀인 경우 반환되는 너비는 0.1입니다.
## 목차
** Height **
높이 전체 문서 페이지 높이에 대한 비율로서 경계 상자의 높이입니다.
Type: 부동 소수점
: 필수 아니요
** Left **
좌측 전체 문서 페이지 너비에 대한 비율로서 경계 상자의 좌측 좌표입니다.
Type: 부동 소수점
: 필수 아니요
** Top **
상단 전체 문서 페이지 높이에 대한 비율로서 경계 상자의 상단 좌표입니다.
Type: 부동 소수점
: 필수 아니요
** Width **
너비 전체 문서 페이지 너비에 대한 비율로서 경계 상자의 너비입니다.
Type: 부동 소수점
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/BoundingBox)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/BoundingBox)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/BoundingBox)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/BoundingBox)
# Document
입력 문서 (바이트 또는 S3 객체) 입니다.
를 사용하여 Amazon Textract API 작업에 이미지 바이트를 전달합니다.`Bytes`속성입니다. 예를 들어 다음을 사용합니다.`Bytes`로컬 파일 시스템에서 로드된 문서를 전달하는 속성입니다. 를 사용하여 전달된 이미지 바이트`Bytes`속성은 base64로 인코딩해야 합니다. AWS SDK를 사용하여 Amazon Textract API 작업을 호출하는 경우 코드가 문서 파일 바이트를 인코딩하지 않아도 될 수 있습니다.
다음을 사용하여 S3 버킷에 저장된 이미지를 Amazon Textract API 작업으로 전달합니다.`S3Object`속성입니다. S3 버킷에 저장된 문서는 base64로 인코딩할 필요가 없습니다.
S3 객체가 있는 S3 버킷의 AWS 리전과 Amazon Textract 작업에 사용하는 AWS 리전과 일치해야 합니다.
AWS CLI를 사용하여 Amazon Textract 작업을 호출하는 경우 Bytes를 사용하여 이미지 바이트를 전달하는 작업은 지원되지 않습니다. 먼저 문서를 Amazon S3 버킷에 업로드한 다음 S3Object 속성을 사용하여 작업을 호출해야 합니다.
Amazon Textract Textract가 S3 객체를 처리하려면 사용자에게 S3 객체에 액세스할 수 있는 권한이 있어야 합니다.
## 목차
** Bytes **
base64로 인코딩된 문서 바이트의 blob입니다. Blob 단위로 제공되는 문서의 최대 크기는 5MB입니다. 문서 바이트는 PNG 또는 JPEG 형식이어야 합니다.
AWS SDK를 사용하여 Amazon Textract Textract를 호출하는 경우 다음을 사용하여 전달된 이미지 바이트를 base64로 인코딩할 필요가 없습니다.`Bytes`필드.
Type: Base64 인코딩 이진수 데이터 객체
길이 제약 조건: 최소 길이는 1이고, 최대 길이 10485760.
: 필수 아니요
** S3Object **
S3 객체를 문서 소스로 식별합니다. S3 버킷에 저장된 문서의 최대 크기는 5MB입니다.
유형: [S3Object](API_S3Object.md) 객체
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Document)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Document)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Document)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Document)
# DocumentLocation
처리할 문서가 저장된 Amazon S3 버킷입니다. 다음과 같은 비동기 작업에서 사용됩니다.[StartDocumentTextDetection](API_StartDocumentTextDetection.md).
입력 문서는 JPEG 또는 PNG 형식의 이미지 파일일 수 있습니다. PDF 형식의 파일일 수도 있습니다.
## 목차
** S3Object **
입력 문서가 저장된 Amazon S3 버킷입니다.
유형: [S3Object](API_S3Object.md) 객체
요구 사항: 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/DocumentLocation)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/DocumentLocation)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/DocumentLocation)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/DocumentLocation)
# DocumentMetadata
입력 문서에 대한 정보입니다.
## 목차
** Pages **
문서에서 검색된 페이지 수입니다.
Type: 정수
유효한 범위: 최소값 0.
필수 사항: 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/DocumentMetadata)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/DocumentMetadata)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/DocumentMetadata)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/DocumentMetadata)
# ExpenseDetection
Amazon Textract Textract에서 감지한 값 또는 라벨에 대한 정보를 저장하는 데 사용되는 객체입니다.
## 목차
** Confidence **
감지에 대한 신뢰도 (백분율)
Type: 부동 소수점
유효한 범위: 최소값 0. 최대값 100입니다.
: 필수 아니요
** Geometry **
검색된 페이지, 텍스트, 키-값 페어, 테이블, 테이블 셀 및 선택 요소와 같은 문서 페이지에서 항목이 있는 위치에 대한 정보.
유형: [Geometry](API_Geometry.md) 객체
: 필수 아니요
** Text **
Amazon Textract Textract에서 인식하는 단어 또는 텍스트 줄
Type: String
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/ExpenseDetection)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/ExpenseDetection)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/ExpenseDetection)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/ExpenseDetection)
# ExpenseDocument
애널리즈피스가 반환한 모든 정보를 담고 있는 구조
## 목차
** ExpenseIndex **
문서의 어떤 인보이스 또는 영수증을 나타냅니다. 따라서 첫 번째 문서는 1이고 두 번째 2입니다.
Type: 정수
유효한 범위: 최소값 0.
: 필수 아니요
** LineItemGroups **
문서의 각 테이블에서 감지된 정보 (`LineItems`.
Type: 배열[LineItemGroup](API_LineItemGroup.md)사물
: 필수 아니요
** SummaryFields **
Amazon Textract Textract에서 테이블 외부에서 발견된 모든 정보입니다.
Type: 배열[ExpenseField](API_ExpenseField.md)사물
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/ExpenseDocument)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/ExpenseDocument)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/ExpenseDocument)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/ExpenseDocument)
# ExpenseField
탐지된 정보의 분석, 카테고리 유형, 레이블 감지 및 값 감지로 구분됩니다.
## 목차
** LabelDetection **
탐지된 요소의 명시적으로 명시된 레이블입니다.
유형: [ExpenseDetection](API_ExpenseDetection.md) 객체
: 필수 아니요
** PageNumber **
값이 감지된 페이지 번호입니다.
Type: 정수
유효한 범위: 최소값 0.
: 필수 아니요
** Type **
탐지된 요소의 암시적 레이블입니다. 명시적 요소에 대한 레이블 탐지와 함께 표시됩니다.
유형: [ExpenseType](API_ExpenseType.md) 객체
: 필수 아니요
** ValueDetection **
탐지된 요소의 값입니다. 명시적 및 암시적 요소에 존재합니다.
유형: [ExpenseDetection](API_ExpenseDetection.md) 객체
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/ExpenseField)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/ExpenseField)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/ExpenseField)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/ExpenseField)
# ExpenseType
Amazon Textract Textract에서 감지한 유형에 대한 정보를 저장하는 데 사용되는 객체입니다.
## 목차
** Confidence **
정확성에 대한 신뢰도를 백분율로 나타냅니다.
Type: 부동 소수점
유효한 범위: 최소값 0. 최대값 100.
필수: 아니요
** Text **
Amazon Textract Textract에서 감지한 단어 또는 텍스트 행입니다.
Type: String
필수: 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/ExpenseType)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/ExpenseType)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/ExpenseType)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/ExpenseType)
# Geometry
검색된 페이지, 텍스트, 키-값 페어, 테이블, 테이블 셀 및 선택 요소와 같은 항목이 문서 페이지에 있는 위치에 대한 정보입니다.
## 목차
** BoundingBox **
문서 페이지에서 인식된 항목의 위치를 축으로 정렬한 거친 표현입니다.
유형: [BoundingBox](API_BoundingBox.md) 객체
: 필수 아니요
** Polygon **
경계 상자 내에서 인식된 항목 주위에 세밀한 다각형이 있습니다.
Type: 배열[Point](API_Point.md)사물
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Geometry)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Geometry)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Geometry)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Geometry)
# HumanLoopActivationOutput
루프 평가에서 사람의 결과를 표시합니다. HumanLooPARN이 없으면 입력이 인간 검토를 트리거하지 않았습니다.
## 목차
** HumanLoopActivationConditionsEvaluationResults **
인간 검토를 활성화한 조건을 포함하여 조건 평가 결과를 표시합니다.
Type: String
길이 제약 조건: 최대 길이 10,240입니다.
: 필수 사항 아니요
** HumanLoopActivationReasons **
사람의 검토가 필요한지 여기와 이유를 보여줍니다.
Type: 문자열 배열
배열 멤버: 최소 항목 수는 1개입니다.
: 필수 사항 아니요
** HumanLoopArn **
생성된 HumanLoop Amazon 리소스 이름 (ARN) 입니다.
Type: String
길이 제약 조건: 최대 길이 256.
: 필수 사항 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/HumanLoopActivationOutput)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/HumanLoopActivationOutput)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/HumanLoopActivationOutput)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/HumanLoopActivationOutput)
# HumanLoopConfig
조건 중 하나가 충족되면 문서를 보낼 사람 검토 워크플로를 설정합니다. 검토하기 전에 이미지의 특정 속성을 설정할 수도 있습니다.
## 목차
** DataAttributes **
입력 데이터의 속성을 설정합니다.
유형: [HumanLoopDataAttributes](API_HumanLoopDataAttributes.md) 객체
: 필수 아니요
** FlowDefinitionArn **
흐름 정의의 Amazon 리소스 이름 (ARN) 입니다.
Type: String
길이 제약 조건: 최대 길이 256.
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** HumanLoopName **
이 이미지에 사용되는 인적 워크플로의 이름입니다. 리전 내에서 고유해야 합니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이 63.
Pattern: `^[a-z0-9](-*[a-z0-9])*`
: 필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/HumanLoopConfig)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/HumanLoopConfig)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/HumanLoopConfig)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/HumanLoopConfig)
# HumanLoopDataAttributes
이미지의 속성을 설정할 수 있습니다. 현재 이미지를 개인 식별 정보 및 성인 콘텐츠가 없는 것으로 선언할 수 있습니다.
## 목차
** ContentClassifiers **
입력 이미지에 개인 식별 정보 또는 성인 콘텐츠가 없다는 것을 설정합니다.
Type: 문자열 배열
어레이 멤버: 최대 항목 수는 256개입니다.
유효한 값:` FreeOfPersonallyIdentifiableInformation | FreeOfAdultContent`
필수: 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/HumanLoopDataAttributes)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/HumanLoopDataAttributes)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/HumanLoopDataAttributes)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/HumanLoopDataAttributes)
# IdentityDocument
AnalyzeID 작업에서 처리된 각 문서를 나열하는 구조입니다.
## 목차
** DocumentIndex **
IdentityDocument 목록에서 문서의 배치를 나타냅니다. 첫 번째 문서는 1로 표시되고 두 번째 문서는 2로 표시됩니다.
Type: 정수
유효한 범위: 최소값 0.
: 필수 아니요
** IdentityDocumentFields **
ID 문서에서 추출한 정보를 기록하는 데 사용되는 구조입니다. 정규화된 필드와 추출된 텍스트의 값을 모두 포함합니다.
Type: 배열[IdentityDocumentField](API_IdentityDocumentField.md)사물
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/IdentityDocument)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/IdentityDocument)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/IdentityDocument)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/IdentityDocument)
# IdentityDocumentField
추출된 정보의 정규화된 유형과 이와 연관된 텍스트를 모두 포함하는 구조체입니다. 이들은 각각 유형 및 값으로 추출됩니다.
## 목차
** Type **
AnalyzeID 작업에서 감지된 정보를 포함하는 데 사용됩니다.
유형: [AnalyzeIDDetections](API_AnalyzeIDDetections.md) 객체
: 필수 아니요
** ValueDetection **
AnalyzeID 작업에서 감지된 정보를 포함하는 데 사용됩니다.
유형: [AnalyzeIDDetections](API_AnalyzeIDDetections.md) 객체
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/IdentityDocumentField)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/IdentityDocumentField)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/IdentityDocumentField)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/IdentityDocumentField)
# LineItemFields
문서 테이블에 있는 여러 줄에 대한 정보를 담고 있는 구조입니다.
## 목차
** LineItemExpenseFields **
테이블에서 감지된 라인의 정보를 표시하는 데 사용되는 ExpenseFields.
Type: 배열[ExpenseField](API_ExpenseField.md)사물
필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/LineItemFields)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/LineItemFields)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/LineItemFields)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/LineItemFields)
# LineItemGroup
LineItems를 포함하는 테이블 그룹화이며, 각 테이블은 테이블로 식별됩니다.`LineItemGroupIndex`.
## 목차
** LineItemGroupIndex **
문서에서 특정 테이블을 식별하는 데 사용되는 번호입니다. 첫 번째 테이블에는 라인 항목 그룹 인덱스 1, 두 번째 2 등이 있습니다.
Type: 정수
유효한 범위: 최소값 0.
: 필수 아니요
** LineItems **
테이블의 특정 행에 대한 정보 분석입니다.
Type: 배열[LineItemFields](API_LineItemFields.md)사물
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/LineItemGroup)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/LineItemGroup)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/LineItemGroup)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/LineItemGroup)
# NormalizedValue
문서의 날짜와 관련된 정보 (값 유형 및 값 포함) 를 포함합니다.
## 목차
** Value **
연월-일수:분:초로 작성된 날짜의 값입니다.
Type: String
: 필수 아니요
** ValueType **
탐지된 값의 정규화된 유형입니다. 이 경우 DATE입니다.
Type: String
유효한 값:` DATE`
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/NormalizedValue)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/NormalizedValue)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/NormalizedValue)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/NormalizedValue)
# NotificationChannel
Amazon Textract가 다음과 같은 비동기 문서 작업의 완료 상태를 게시할 Amazon Simple Notification Service (Amazon SNS) 주제를 생성합니다.[StartDocumentTextDetection](API_StartDocumentTextDetection.md).
## 목차
** RoleArn **
Amazon Textract에 Amazon SNS 주제에 대한 게시 권한을 부여하는 IAM 역할의 Amazon 리소스 이름 (ARN) 입니다.
Type: String
길이 제약 조건: 최소 길이 20. 최대 길이 2048.
Pattern: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`
필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** SNSTopicArn **
Amazon Textract가 완료 상태를 게시하는 Amazon SNS 주제입니다.
Type: String
길이 제약 조건: 최소 길이 20. 최대 길이는 1,024입니다.
Pattern: `(^arn:([a-z\d-]+):sns:[a-zA-Z\d-]{1,20}:\w{12}:.+$)`
필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/NotificationChannel)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/NotificationChannel)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/NotificationChannel)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/NotificationChannel)
# OutputConfig
출력이 사용자 생성 버킷으로 이동할지 여부를 설정합니다. 버킷의 이름과 출력 파일의 접두사를 설정하는 데 사용됩니다.
`OutputConfig`는 출력 위치를 조정할 수 있는 선택적 매개 변수입니다. 기본적으로 Amazon Textract Textract는 결과를 내부적으로 저장하며 Get API 작업에서만 액세스할 수 있습니다. OutputConfig를 활성화하면 출력이 전송될 버킷의 이름과 결과를 다운로드할 수 있는 결과의 파일 접두사를 설정할 수 있습니다. 또한 다음을 설정할 수 있습니다.`KMSKeyID`CMK (고객 마스터 키) 를 사용하여 출력을 암호화합니다. 이 매개 변수를 설정하지 않으면 Amazon Textract Textract는 Amazon S3 S3용 AWS 관리형 CMK를 사용하여 서버 측을 암호화합니다.
Amazon Textract Textract에서 문서를 처리하려면 고객 콘텐츠의 암호 해독이 필요합니다. AI 서비스 옵트아웃 정책에 따라 계정이 옵트아웃된 경우, 서비스에서 고객 콘텐츠를 처리한 후 암호화되지 않은 모든 고객 콘텐츠가 즉시 영구적으로 삭제됩니다. 출력의 사본은 Amazon Textract Textract에 의해 보존되지 않습니다. 자세한 선택 해제 방법은 단원을 참조하십시오.[AI 서비스 옵트아웃 정책 관리.](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html)
데이터 프라이버시에 대한 자세한 내용은 단원을 참조하십시오.[데이터 프라이버시 FAQ](https://aws.amazon.com/compliance/data-privacy-faq/).
## 목차
** S3Bucket **
출력된 버킷의 이름.
Type: String
길이 제약 조건: 최소 길이는 3이고, 최대 길이 255.
Pattern: `[0-9A-Za-z\.\-_]*`
필수 프로세스는 페이지 쓰기 후 세그먼트화된 가장 오래전에 사용된(SLRU) 데이터가 내구성 있는 스토리지에 도달할 때까지 기다리고 있습니다.
** S3Prefix **
출력을 저장할 객체 키의 접두사입니다. 활성화되지 않은 경우 접두사는 “textract\$1output”이 됩니다.
Type: String
길이 제약 조건: 최소 길이는 1이고, 최대 길이는 1,024입니다.
Pattern: `.*\S.*`
필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/OutputConfig)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/OutputConfig)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/OutputConfig)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/OutputConfig)
# Point
문서 페이지에 있는 점의 X 및 Y 좌표입니다. 반환되는 X 및 Y 값은 전체 문서 페이지 크기의 비율입니다. 예를 들어 입력 문서가 700 x 200이고 작업이 X=0.5이고 Y=0.25를 반환하는 경우 점은 문서 페이지의 (350,50) 픽셀 좌표에 있습니다.
의 어레이`Point`객체입니다.`Polygon`이 (가) 의 일부로 반환됩니다.[Geometry](API_Geometry.md)에서 반환되는 객체[Block](API_Block.md)객체입니다. A`Polygon`object는 감지된 텍스트, 키-값 쌍, 표, 표 셀 또는 선택 요소 주위의 세밀한 다각형을 나타냅니다.
## 목차
** X **
a 상의 점에 대한 X 좌표 값입니다.`Polygon`.
Type: 부동 소수점
: 필수 아니요
** Y **
a 상의 점에 대한 Y 좌표의 값입니다.`Polygon`.
Type: 부동 소수점
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Point)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Point)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Point)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Point)
# Relationship
블록이 서로 어떻게 관련되어 있는지에 대한 정보입니다. A`Block`개체에 0 이상 포함`Relation`리스트에 있는 객체,`Relationships`. 자세한 정보는 [Block](API_Block.md)을 참조하십시오.
이`Type`요소는 모든 블록에 대한 관계 유형을 제공합니다.`IDs`어레이.
## 목차
** Ids **
관련 블록에 대한 ID 배열입니다. 에서 관계의 유형을 볼 수 있습니다.`Type`요소.
Type: 문자열 배열
Pattern: `.*\S.*`
필수 사항: 아니요
** Type **
ID 배열의 블록이 현재 블록과 갖는 관계 유형입니다. 관계는 다음과 같습니다.`VALUE`또는`CHILD`. VALUE 유형의 관계는 키-값 쌍의 KEY와 연결된 VALUE 블록의 ID를 포함하는 목록입니다. CHALD 유형의 관계는 행의 경우 WORD 블록을 식별하는 ID 목록입니다. 테이블의 경우 셀 블록과 선택 요소의 경우 WORD 블록을 식별합니다.
Type: String
유효한 값:` VALUE | CHILD | COMPLEX_FEATURES`
필수 사항: 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Relationship)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Relationship)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Relationship)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Relationship)
# S3Object
문서를 식별하는 S3 버킷 이름 및 파일 이름입니다.
문서가 포함된 S3 버킷의 AWS 리전은 Amazon Textract 작업에 사용하는 리전과 일치해야 합니다.
Amazon Textract Textract가 S3 버킷의 파일을 처리하려면 사용자에게 S3 버킷과 파일에 액세스할 수 있는 권한이 있어야 합니다.
## 목차
** Bucket **
S3 버킷의 이름 파일 이름에는 \$1 문자가 유효하지 않습니다.
Type: String
길이 제약: 최소 길이는 3이고, 최대 길이 255.
Pattern: `[0-9A-Za-z\.\-_]*`
: 필수 아니요
** Name **
입력 문서의 파일 이름입니다. 동기 작업은 JPEG 또는 PNG 형식의 이미지 파일을 사용할 수 있습니다. 비동기 작업은 PDF 및 TIFF 형식 파일도 지원합니다.
Type: String
길이 제약: 최소 길이는 1이고, 최대 길이는 1,024입니다.
Pattern: `.*\S.*`
: 필수 아니요
** Version **
버킷의 버전 관리가 활성화된 경우 객체 버전을 지정할 수 있습니다.
Type: String
길이 제약: 최소 길이는 1이고, 최대 길이는 1,024입니다.
Pattern: `.*\S.*`
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/S3Object)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/S3Object)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/S3Object)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/S3Object)
# Warning
비동기 텍스트 분석 중 발생한 문제에 대한 경고 ([StartDocumentAnalysis](API_StartDocumentAnalysis.md)) 또는 비동기 문서 텍스트 감지 ([StartDocumentTextDetection](API_StartDocumentTextDetection.md)).
## 목차
** ErrorCode **
경고에 대한 오류 코드입니다.
Type: String
: 필수 아니요
** Pages **
경고가 적용되는 페이지의 목록입니다.
Type: 정수 배열
유효한 범위: 최소값 0.
: 필수 아니요
## 참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Warning)
+ [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Warning)
+ [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Warning)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Warning)