Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Referencia de la API
Esta sección proporciona documentación sobre las operaciones de la API de Amazon Textract.
**Topics**
+ [Acciones](API_Operations.md)
+ [Tipos de datos](API_Types.md)
# Acciones
Se admiten las siguientes acciones:
+ [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
Analiza un documento de entrada en busca de relaciones entre elementos detectados.
Los tipos de información devuelta son los siguientes:
+ Datos de formulario (pares de clave-valor). La información relacionada se devuelve en dos[Block](API_Block.md)objetos, cada uno de tipo`KEY_VALUE_SET`: una LLAVE`Block`objeto y un VALOR`Block`objeto. Por ejemplo,*Name: Ana Silva Carolina*contiene una clave y un valor. *Name:*es la clave. *Ana Silva Carolina*es el valor.
+ Datos de celdas de tabla y tabla. UNA TABLA`Block`contiene información sobre una tabla detectada. UNA CELDA`Block`se devuelve para cada celda de una tabla.
+ Líneas y palabras de texto. UNA LÍNEA`Block`contiene uno o varios WORD`Block`objetos. Se devuelven todas las líneas y palabras detectadas en el documento (incluido el texto que no tiene relación con el valor de`FeatureTypes`).
Los elementos de selección, tales como casillas de verificación y botones de opción (botones de opción) se pueden detectar en los datos del formulario y en las tablas. UN ELEMENTO SELECTION\$1ELEMENT`Block`contiene información sobre un elemento de selección, incluido el estado de la selección.
Puede elegir qué tipo de análisis desea realizar especificando la`FeatureTypes`lista.
La salida se devuelve en una lista de`Block`objetos.
`AnalyzeDocument`es una operación síncrona. Para analizar documentos de forma asíncrona, utilice[StartDocumentAnalysis](API_StartDocumentAnalysis.md).
Para obtener más información, consulte[Análisis de texto de documentos](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html).
## Sintaxis de la solicitud
```
{
"Document": {
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
},
"FeatureTypes": [ "string" ],
"HumanLoopConfig": {
"DataAttributes": {
"ContentClassifiers": [ "string" ]
},
"FlowDefinitionArn": "string",
"HumanLoopName": "string"
}
}
```
## Parámetros de solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [Document](#API_AnalyzeDocument_RequestSyntax) **
El documento de entrada como bytes codificados en base64 o un objeto Amazon S3. Si utiliza la CLI de AWS para llamar a las operaciones de Amazon Textract Texact, no puede pasar bytes de imagen. El documento debe ser una imagen en formato JPEG, PNG, PDF o TIFF.
Si utiliza un SDK de AWS para llamar a Amazon Textract, es posible que no tenga que codificar en base 64 bytes de imagen que se pasan mediante el`Bytes`.
Tipo: objeto [Document](API_Document.md)
Obligatorio: Sí
** [FeatureTypes](#API_AnalyzeDocument_RequestSyntax) **
Lista de los tipos de análisis que se van a realizar. Agregue TABLES a la lista para devolver información sobre las tablas detectadas en el documento de entrada. Añada FORMULARIOS para devolver los datos del formulario detectados. Para realizar ambos tipos de análisis, agregue TABLES y FORMS a`FeatureTypes`. Todas las líneas y palabras detectadas en el documento se incluyen en la respuesta (incluido el texto que no está relacionado con el valor de`FeatureTypes`).
Type: Matriz de cadenas
Valores válidos:` TABLES | FORMS`
Obligatorio: Sí
** [HumanLoopConfig](#API_AnalyzeDocument_RequestSyntax) **
Establece la configuración del flujo de trabajo humano en bucle para analizar documentos.
Tipo: objeto [HumanLoopConfig](API_HumanLoopConfig.md)
Obligatorio: No
## Sintaxis de la respuesta
```
{
"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"
}
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [AnalyzeDocumentModelVersion](#API_AnalyzeDocument_ResponseSyntax) **
La versión del modelo que se utiliza para analizar el documento.
Type: Cadena
** [Blocks](#API_AnalyzeDocument_ResponseSyntax) **
Los elementos detectados y analizados por`AnalyzeDocument`.
Type: Matriz de[Block](API_Block.md)objects
** [DocumentMetadata](#API_AnalyzeDocument_ResponseSyntax) **
Metadatos sobre el documento analizado. Un ejemplo es el número de páginas.
Tipo: objeto [DocumentMetadata](API_DocumentMetadata.md)
** [HumanLoopActivationOutput](#API_AnalyzeDocument_ResponseSyntax) **
Muestra los resultados de la evaluación humana en bucle.
Tipo: objeto [HumanLoopActivationOutput](API_HumanLoopActivationOutput.md)
## Errores
** AccessDeniedException **
No tiene autorización para realizar la acción. Utilice el nombre de recurso de Amazon (ARN) de un usuario autorizado o un rol de IAM para realizar la operación.
Código de estado HTTP: 400
** BadDocumentException **
Amazon Textract Texact no puede leer el documento. Para obtener más información sobre los límites de documentos en Amazon Textract, consulte[Límites máximos de Amazon Textract](limits.md).
Código de estado HTTP: 400
** DocumentTooLargeException **
El documento no se puede procesar porque es demasiado grande. Tamaño máximo de documento para operaciones síncronas de 10 MB. El tamaño máximo de documento para las operaciones asíncronas es de 500 MB para los archivos PDF.
Código de estado HTTP: 400
** HumanLoopQuotaExceededException **
Indica que ha superado la cantidad máxima de personas activas en los flujos de trabajo de bucle disponibles
Código de estado HTTP: 400
** InternalServerError **
Amazon Textract ha tenido un problema de servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** InvalidParameterException **
Un parámetro de entrada infringió una restricción. Por ejemplo, en operaciones sincrónicas, un`InvalidParameterException`se produce cuando ninguno de los`S3Object`o`Bytes`los valores se proporcionan en el`Document`parámetro de solicitud. Valide el parámetro antes de llamar a la operación de la API de nuevo.
Código de estado HTTP: 400
** InvalidS3ObjectException **
Amazon Textract Texact no puede obtener acceso al objeto de S3 que se especifica en la solicitud. Para obtener más información,[Configuración del acceso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obtener información sobre la resolución de problemas, consulte[Solución de problemas de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Código de estado HTTP: 400
** ProvisionedThroughputExceededException **
El número de solicitudes ha superado su límite de rendimiento. Si necesita aumentar este límite, póngase en contacto con Amazon Textract.
Código de estado HTTP: 400
** ThrottlingException **
Amazon Textract no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** UnsupportedDocumentException **
El formato del documento de entrada no se admite. Los documentos para operaciones pueden estar en formato PNG, JPEG, PDF o TIFF.
Código de estado HTTP: 400
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeDocument)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeDocument)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeDocument)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeDocument)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeDocument)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeDocument)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeDocument)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeDocument)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeDocument)
# AnalyzeExpense
`AnalyzeExpense`analiza sincrónicamente un documento de entrada para ver las relaciones financieras entre texto.
La información se devuelve como`ExpenseDocuments`y separados de la siguiente manera.
+ `LineItemGroups`- Conjunto de datos que contiene`LineItems`que almacenan información sobre las líneas de texto, como un artículo comprado y su precio en un recibo.
+ `SummaryFields`- Contiene toda la demás información de un recibo, como la información del encabezado o el nombre del proveedor.
## Sintaxis de la solicitud
```
{
"Document": {
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
}
```
## Parámetros de solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [Document](#API_AnalyzeExpense_RequestSyntax) **
El documento de entrada, ya sea en bytes o como objeto S3.
Puede transferir bytes de imágenes a una operación API Amazon Textract Texact utilizando la`Bytes`propiedad. Por ejemplo, usaría el`Bytes`para pasar un documento cargado desde un sistema de archivos local. Bytes de imagen pasados mediante el`Bytes`debe tener codificación base64. Es posible que el código no necesite codificar bytes de archivos de documentos si utiliza un SDK de AWS para llamar a las operaciones de la API de Amazon Textract Texact.
Puede transferir imágenes almacenadas en un bucket de S3 a una operación API Amazon Textract Texact utilizando el`S3Object`propiedad. Los documentos almacenados en un bucket de S3 no tienen por qué estar codificados en base64.
La región de AWS para el bucket de S3 que contiene el objeto S3 debe coincidir con la región de AWS que utiliza para las operaciones de Amazon Textract Texact.
Si utiliza la CLI de AWS para llamar a las operaciones de Amazon Textract Texact, no es posible transferir bytes de imágenes utilizando la propiedad Bytes. Debe cargar primero el documento en un bucket de Amazon S3 y, a continuación, llamar a la operación utilizando la propiedad S3Object.
Para que Amazon Textract Texact procese un objeto de S3, el usuario debe tener permiso para acceder al objeto de S3.
Tipo: objeto [Document](API_Document.md)
Obligatorio: Sí
## Sintaxis de la respuesta
```
{
"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"
}
}
]
}
]
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [DocumentMetadata](#API_AnalyzeExpense_ResponseSyntax) **
Información sobre el documento de entrada.
Tipo: objeto [DocumentMetadata](API_DocumentMetadata.md)
** [ExpenseDocuments](#API_AnalyzeExpense_ResponseSyntax) **
Los gastos detectados por Amazon Textract.
Type: Matriz de[ExpenseDocument](API_ExpenseDocument.md)objects
## Errores
** AccessDeniedException **
No tiene autorización para realizar la acción. Utilice el nombre de recurso de Amazon (ARN) de un usuario autorizado o un rol de IAM para realizar la operación.
Código de estado HTTP: 400
** BadDocumentException **
Amazon Textract Texact no puede leer el documento. Para obtener más información sobre los límites de documentos en Amazon Textract, consulte[Límites máximos de Amazon Textract](limits.md).
Código de estado HTTP: 400
** DocumentTooLargeException **
El documento no se puede procesar porque es demasiado grande. Tamaño máximo de documento para operaciones síncronas de 10 MB. El tamaño máximo de documento para operaciones asíncronas es de 500 MB para los archivos PDF.
Código de estado HTTP: 400
** InternalServerError **
Amazon Textract ha tenido un problema de servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** InvalidParameterException **
Un parámetro de entrada infringió una restricción. Por ejemplo, en operaciones sincrónicas, un`InvalidParameterException`se produce cuando ninguno de los`S3Object`o`Bytes`los valores se proporcionan en el`Document`parámetro de solicitud. Valide el parámetro antes de llamar a la operación de la API de nuevo.
Código de estado HTTP: 400
** InvalidS3ObjectException **
Amazon Textract no puede obtener acceso al objeto de S3 que se especifica en la solicituda. para obtener más información,[Configuración del acceso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obtener información sobre la resolución de problemas, consulte[Solución de problemas de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Código de estado HTTP: 400
** ProvisionedThroughputExceededException **
El número de solicitudes ha superado su límite de rendimiento. Si necesita aumentar este límite, póngase en contacto con Amazon Textract.
Código de estado HTTP: 400
** ThrottlingException **
Amazon Textract Texact no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** UnsupportedDocumentException **
El formato del documento de entrada no es posible. Los documentos para operaciones pueden estar en formato PNG, JPEG, PDF o TIFF.
Código de estado HTTP: 400
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeExpense)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeExpense)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeExpense)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeExpense)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeExpense)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeExpense)
# AnalyzeID
Analiza los documentos de identidad para obtener información relevante. Esta información se extrae y se devuelve como`IdentityDocumentFields`, que registra tanto el campo normalizado como el valor del texto extraído. A diferencia de otras operaciones de Amazon Textract Texact,`AnalyzeID`no devuelve ningún dato de geometría.
## Sintaxis de la solicitud
```
{
"DocumentPages": [
{
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
]
}
```
## Parámetros de solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [DocumentPages](#API_AnalyzeID_RequestSyntax) **
El documento que se pasa a AnalyzeID.
Type: Matriz de[Document](API_Document.md)objects
Miembros de la matriz: Número mínimo de 1 elemento. Número máximo de 2 elementos.
Obligatorio: Sí
## Sintaxis de la respuesta
```
{
"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"
}
}
]
}
]
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [AnalyzeIDModelVersion](#API_AnalyzeID_ResponseSyntax) **
Versión de la API AnalyzeIdentity que se utiliza para procesar documentos.
Type: Cadena
** [DocumentMetadata](#API_AnalyzeID_ResponseSyntax) **
Información sobre el documento de entrada.
Tipo: objeto [DocumentMetadata](API_DocumentMetadata.md)
** [IdentityDocuments](#API_AnalyzeID_ResponseSyntax) **
Lista de documentos procesados por AnalyzeID. Incluye un número que indica su lugar en la lista y la estructura de respuestas del documento.
Type: Matriz de[IdentityDocument](API_IdentityDocument.md)objects
## Errores
** AccessDeniedException **
No tiene autorización para realizar la acción. Utilice el nombre de recurso de Amazon (ARN) de un usuario autorizado o un rol de IAM para realizar la operación.
Código de estado HTTP: 400
** BadDocumentException **
Amazon Textract Texact no puede leer el documento. Para obtener más información sobre los límites de documentos en Amazon Textract, consulte[Límites máximos de Amazon Textract](limits.md).
Código de estado HTTP: 400
** DocumentTooLargeException **
El documento no se puede procesar porque es demasiado grande. Tamaño máximo de documento para operaciones síncronas de 10 MB. El tamaño máximo de documento para las operaciones asíncronas es de 500 MB para los archivos PDF.
Código de estado HTTP: 400
** InternalServerError **
Amazon Textract ha tenido un problema de servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** InvalidParameterException **
Un parámetro de entrada infringió una restricción. Por ejemplo, en operaciones sincrónicas, un`InvalidParameterException`se produce cuando ninguno de los`S3Object`o`Bytes`los valores se proporcionan en el`Document`parámetro de solicitud. Valide el parámetro antes de llamar a la operación de la API de nuevo.
Código de estado HTTP: 400
** InvalidS3ObjectException **
Amazon Textract Texact no puede obtener acceso al objeto de S3 que se especificó en la solicitud. Para obtener más información,[Configuración del acceso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obtener información sobre la resolución de problemas, consulte[Solución de problemas de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Código de estado HTTP: 400
** ProvisionedThroughputExceededException **
El número de solicitudes ha superado su límite de rendimiento. Si necesita aumentar este límite, póngase en contacto con Amazon Textract.
Código de estado HTTP: 400
** ThrottlingException **
Amazon Textract Texact no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** UnsupportedDocumentException **
El formato del documento de entrada no es compatible. Los documentos para operaciones pueden estar en formato PNG, JPEG, PDF o TIFF.
Código de estado HTTP: 400
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeID)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeID)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeID)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeID)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeID)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeID)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeID)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeID)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeID)
# DetectDocumentText
Detecta el texto del documento de entrada. Amazon Textract Texact puede detectar líneas de texto y las palabras que componen una línea de texto. El documento de entrada debe ser una imagen en formato JPEG, PNG, PDF o TIFF.`DetectDocumentText`devuelve el texto detectado en una matriz de[Block](API_Block.md)objetos.
Cada página de documento tiene como asociado`Block`de tipo PAGE. Cada PÁGINA`Block`object es el principal de LINE`Block`objetos que representan las líneas del texto detectado en una página. UNA LÍNEA`Block`objeto es un padre para cada palabra que forma la línea. Las palabras están representadas por`Block`objetos de tipo WORD.
`DetectDocumentText`es una operación síncrona. Para analizar documentos de forma asíncrona, utilice[StartDocumentTextDetection](API_StartDocumentTextDetection.md).
Para obtener más información, consulte[Detección de texto de documentos](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html).
## Sintaxis de la solicitud
```
{
"Document": {
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
}
```
## Parámetros de solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [Document](#API_DetectDocumentText_RequestSyntax) **
El documento de entrada como bytes codificados en base64 o un objeto Amazon S3. Si utiliza la CLI de AWS para llamar a las operaciones de Amazon Textract Texact, no puede pasar bytes de imagen. El documento debe ser una imagen en formato JPEG o PNG.
Si utiliza un SDK de AWS para llamar a Amazon Textract, es posible que no tenga que codificar en base 64 bytes de imagen que se pasan mediante el`Bytes`.
Tipo: objeto [Document](API_Document.md)
Obligatorio: Sí
## Sintaxis de la respuesta
```
{
"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
}
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [Blocks](#API_DetectDocumentText_ResponseSyntax) **
Una matriz de`Block`objetos que contienen el texto detectado en el documento.
Type: Matriz de[Block](API_Block.md)objects
** [DetectDocumentTextModelVersion](#API_DetectDocumentText_ResponseSyntax) **
Type: Cadena
** [DocumentMetadata](#API_DetectDocumentText_ResponseSyntax) **
Metadatos sobre el documento. Contiene el número de páginas detectadas en el documento.
Tipo: objeto [DocumentMetadata](API_DocumentMetadata.md)
## Errores
** AccessDeniedException **
No tiene autorización para realizar la acción. Utilice el nombre de recurso de Amazon (ARN) de un usuario autorizado o un rol de IAM para realizar la operación.
Código de estado HTTP: 400
** BadDocumentException **
Amazon Textract Texact no puede leer el documento. Para obtener más información sobre los límites de documentos en Amazon Textract, consulte[Límites máximos de Amazon Textract](limits.md).
Código de estado HTTP: 400
** DocumentTooLargeException **
El documento no se puede procesar porque es demasiado grande. Tamaño máximo de documento para operaciones síncronas de 10 MB. El tamaño máximo de documento para las operaciones asíncronas es de 500 MB para los archivos PDF.
Código de estado HTTP: 400
** InternalServerError **
Amazon Textract ha tenido un problema de servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** InvalidParameterException **
Un parámetro de entrada infringió una restricción. Por ejemplo, en operaciones sincrónicas, un`InvalidParameterException`se produce cuando ninguno de los`S3Object`o`Bytes`los valores se proporcionan en el`Document`parámetro de solicitud. Valide el parámetro antes de llamar a la operación de la API de nuevo.
Código de estado HTTP: 400
** InvalidS3ObjectException **
Amazon Textract no puede obtener acceso al objeto de S3 que se especificó en la solicituda. para obtener más información,[Configuración del acceso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obtener información sobre la resolución de problemas, consulte[Solución de problemas de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Código de estado HTTP: 400
** ProvisionedThroughputExceededException **
El número de solicitudes ha superado su límite de rendimiento. Si necesita aumentar este límite, póngase en contacto con Amazon Textract.
Código de estado HTTP: 400
** ThrottlingException **
Amazon Textract Texact no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** UnsupportedDocumentException **
El formato del documento de entrada no se admite. Los documentos para operaciones pueden estar en formato PNG, JPEG, PDF o TIFF.
Código de estado HTTP: 400
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/DetectDocumentText)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/DetectDocumentText)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/DetectDocumentText)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/DetectDocumentText)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/DetectDocumentText)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/DetectDocumentText)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/DetectDocumentText)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/DetectDocumentText)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/DetectDocumentText)
# GetDocumentAnalysis
Obtiene los resultados de una operación asíncrona de Amazon Textract Texact que analiza el texto de un documento.
Para iniciar un análisis de texto asíncrono, llama a[StartDocumentAnalysis](API_StartDocumentAnalysis.md), que devuelve un identificador de trabajo (`JobId`). Cuando finaliza la operación de análisis de texto, Amazon Textract Texact publica un estado de finalización en el tema de Amazon Simple Notification Service (Amazon SNS) registrado en la llamada inicial a`StartDocumentAnalysis`. Para obtener los resultados de la operación de detección de texto, compruebe primero que el valor de estado publicado en el tema de Amazon SNS es`SUCCEEDED`. Si es así, llame`GetDocumentAnalysis`y pasa el identificador de trabajo (`JobId`) desde la llamada inicial hasta`StartDocumentAnalysis`.
`GetDocumentAnalysis`devuelve una matriz de[Block](API_Block.md)objetos. Se devuelven los siguientes tipos de información:
+ Datos del formulario (pares de clave-valor). La información relacionada se devuelve en dos.[Block](API_Block.md)objetos, cada uno de tipo`KEY_VALUE_SET`: una LLAVE`Block`objeto y un VALOR`Block`objeto. Por ejemplo,*Name: Ana Silva Carolina*contiene una clave y un valor. *Name:*es la clave. *Ana Silva Carolina*es el valor.
+ Datos de celdas de tabla y tabla. UNA MESA`Block`contiene información sobre una tabla detectada. UNA CELDA`Block`se devuelve para cada celda de una tabla.
+ Líneas y palabras de texto. UNA LÍNEA`Block`un objeto contiene uno o varios WORD`Block`objetos. Se devuelven todas las líneas y palabras detectadas en el documento (incluido el texto que no tiene relación con el valor del`StartDocumentAnalysis` `FeatureTypes`parámetro de entrada).
Los elementos de selección, tales como casillas de verificación y botones de opción (botones de opción) se pueden detectar en los datos del formulario y en las tablas. A SELECTION\$1ELEMENT`Block`contiene información sobre un elemento de selección, incluido el estado de selección.
Usar`MaxResults`para limitar el número de bloques devueltos. Si hay más resultados de los especificados en`MaxResults`, el valor de`NextToken`en la respuesta de la operación contiene un token de paginación para obtener el siguiente conjunto de resultados. Para obtener la siguiente página de resultados, llame a`GetDocumentAnalysis`, y rellénela`NextToken`parámetro request con el valor de token que se devuelve de la llamada anterior a`GetDocumentAnalysis`.
Para obtener más información, consulte[Análisis de texto de documentos](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html).
## Sintaxis de la solicitud
```
{
"JobId": "string",
"MaxResults": number,
"NextToken": "string"
}
```
## Parámetros de solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [JobId](#API_GetDocumentAnalysis_RequestSyntax) **
Un identificador único del trabajo de detección de texto. La`JobId`se devuelve desde`StartDocumentAnalysis`. UNA`JobId`El valor solo es válido durante 7 días.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `^[a-zA-Z0-9-_]+$`
Obligatorio: Sí
** [MaxResults](#API_GetDocumentAnalysis_RequestSyntax) **
El número máximo de resultados que devolver por llamada paginada. El valor mayor que puede especificar es 1,000. Si especifica un valor superior a 1 000, se devolverá un máximo de 1 000 resultados. El valor predeterminado es 1,000.
Type: Entero
Rango válido: Valor mínimo de 1.
Obligatorio: No
** [NextToken](#API_GetDocumentAnalysis_RequestSyntax) **
Si la respuesta anterior estaba incompleta (porque hay más bloques que recuperar), Amazon Texact devuelve un token de paginación en la respuesta. Puede utilizar este token de paginación para recuperar el siguiente conjunto de bloques.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón: `.*\S.*`
Obligatorio: No
## Sintaxis de la respuesta
```
{
"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 ]
}
]
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [AnalyzeDocumentModelVersion](#API_GetDocumentAnalysis_ResponseSyntax) **
Type: Cadena
** [Blocks](#API_GetDocumentAnalysis_ResponseSyntax) **
Los resultados de la operación de análisis de texto.
Type: Matriz de[Block](API_Block.md)objects
** [DocumentMetadata](#API_GetDocumentAnalysis_ResponseSyntax) **
Información sobre un documento que Amazon Textract procesó.`DocumentMetadata`se devuelve en cada página de respuestas paginadas de una operación de vídeo de Amazon Textract Texact.
Tipo: objeto [DocumentMetadata](API_DocumentMetadata.md)
** [JobStatus](#API_GetDocumentAnalysis_ResponseSyntax) **
El estado actual del trabajo de detección de texto.
Type: Cadena
Valores válidos:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS`
** [NextToken](#API_GetDocumentAnalysis_ResponseSyntax) **
Si la respuesta se trunca, Amazon Textract devuelve este token. Puede utilizar este token en la solicitud subsiguiente para recuperar el siguiente conjunto de resultados de detección de texto.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón: `.*\S.*`
** [StatusMessage](#API_GetDocumentAnalysis_ResponseSyntax) **
Devuelve si el trabajo de detección no se ha podido completar. Contiene explicación de qué error se ha producido.
Type: Cadena
** [Warnings](#API_GetDocumentAnalysis_ResponseSyntax) **
Lista de advertencias que se produjeron durante la operación de análisis de documentos.
Type: Matriz de[Warning](API_Warning.md)objects
## Errores
** AccessDeniedException **
No tiene autorización para realizar la acción. Utilice el nombre de recurso de Amazon (ARN) de un usuario autorizado o un rol de IAM para realizar la operación.
Código de estado HTTP: 400
** InternalServerError **
Amazon Textract ha tenido un problema de servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** InvalidJobIdException **
Se ha pasado un identificador de trabajo no válido a[GetDocumentAnalysis](#API_GetDocumentAnalysis)o para[GetDocumentAnalysis](#API_GetDocumentAnalysis).
Código de estado HTTP: 400
** InvalidKMSKeyException **
Indica que no tiene permisos de descifrado con la clave KMS introducida o que la clave KMS se ha introducido de forma incorrecta.
Código de estado HTTP: 400
** InvalidParameterException **
Un parámetro de entrada infringió una restricción. Por ejemplo, en operaciones sincrónicas, un`InvalidParameterException`se produce cuando ninguno de los`S3Object`o`Bytes`los valores se proporcionan en el`Document`parámetro de solicitud. Valide el parámetro antes de llamar a la operación de la API de nuevo.
Código de estado HTTP: 400
** InvalidS3ObjectException **
Amazon Textract Texact no puede obtener acceso al objeto de S3 especificado en la solicituda. para obtener más información,[Configurar el acceso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obtener información sobre la resolución de problemas, consulte[Solución de problemas de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Código de estado HTTP: 400
** ProvisionedThroughputExceededException **
El número de solicitudes ha superado su límite de rendimiento. Si quieres aumentar este límite, ponte en contacto con Amazon Textract.
Código de estado HTTP: 400
** ThrottlingException **
Amazon Textract Texact no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetDocumentAnalysis)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetDocumentAnalysis)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetDocumentAnalysis)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetDocumentAnalysis)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetDocumentAnalysis)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetDocumentAnalysis)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetDocumentAnalysis)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetDocumentAnalysis)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetDocumentAnalysis)
# GetDocumentTextDetection
Obtiene los resultados de una operación asíncrona de Amazon Texact que detecta texto de un documento. Amazon Textract Texact puede detectar líneas de texto y las palabras que componen una línea de texto.
Se inicia la detección de texto asíncrona llamando[StartDocumentTextDetection](API_StartDocumentTextDetection.md), que devuelve un identificador de trabajo (`JobId`). Cuando finaliza la operación de detección de texto, Amazon Textract Texact publica un estado de finalización en el tema de Amazon Simple Notification Service (Amazon SNS) registrado en la llamada inicial a`StartDocumentTextDetection`. Para obtener los resultados de la operación de detección de texto, compruebe primero que el valor de estado publicado en el tema de Amazon SNS es`SUCCEEDED`. Si es así, llame`GetDocumentTextDetection`y pasa el identificador de trabajo (`JobId`) desde la llamada inicial hasta`StartDocumentTextDetection`.
`GetDocumentTextDetection`devuelve una matriz de[Block](API_Block.md)objetos.
Cada página de documento tiene como asociado`Block`de tipo PAGE. Cada PÁGINA`Block`el objeto es el principal de LINE`Block`objetos que representan las líneas del texto detectado en una página. UNA LÍNEA`Block`objeto es un padre para cada palabra que forma la línea. Las palabras están representadas por`Block`objetos de tipo WORD.
Utilice el parámetro MaxResults para limitar el número de bloques devueltos. Si hay más resultados de los especificados en`MaxResults`, el valor de`NextToken`en la respuesta de la operación contiene un token de paginación para obtener el siguiente conjunto de resultados. Para obtener la siguiente página de resultados, llame`GetDocumentTextDetection`y rellénela`NextToken`parámetro request con el valor de token que se devuelve de la llamada anterior a`GetDocumentTextDetection`.
Para obtener más información, consulte[Detección de texto de documentos](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html).
## Sintaxis de la solicitud
```
{
"JobId": "string",
"MaxResults": number,
"NextToken": "string"
}
```
## Parámetros de solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [JobId](#API_GetDocumentTextDetection_RequestSyntax) **
Un identificador único para el trabajo de detección de texto. La`JobId`se devuelve desde`StartDocumentTextDetection`. UNA`JobId`El valor solo es válido durante 7 días.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `^[a-zA-Z0-9-_]+$`
Obligatorio: Sí
** [MaxResults](#API_GetDocumentTextDetection_RequestSyntax) **
El número máximo de resultados que devolver por llamada paginada. El valor más grande que puede especificar es 1,000. Si especifica un valor superior a 1 000, se devolverá un máximo de 1 000 resultados. El valor predeterminado es 1,000.
Type: Entero
Rango válido: Valor mínimo de 1.
Obligatorio: No
** [NextToken](#API_GetDocumentTextDetection_RequestSyntax) **
Si la respuesta anterior estaba incompleta (porque hay más bloques que recuperar), Amazon Texact devuelve un token de paginación en la respuesta. Puede utilizar este token de paginación para recuperar el siguiente conjunto de bloques.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón: `.*\S.*`
Obligatorio: No
## Sintaxis de la respuesta
```
{
"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 ]
}
]
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [Blocks](#API_GetDocumentTextDetection_ResponseSyntax) **
Los resultados de la operación de detección de texto.
Type: Matrices de[Block](API_Block.md)objects
** [DetectDocumentTextModelVersion](#API_GetDocumentTextDetection_ResponseSyntax) **
Type: Cadena
** [DocumentMetadata](#API_GetDocumentTextDetection_ResponseSyntax) **
Información sobre un documento que Amazon Textract procesó.`DocumentMetadata`se devuelve en cada página de respuestas paginadas de una operación de vídeo de Amazon Textract Texact.
Tipo: objeto [DocumentMetadata](API_DocumentMetadata.md)
** [JobStatus](#API_GetDocumentTextDetection_ResponseSyntax) **
El estado actual del trabajo de detección de texto.
Type: Cadena
Valores válidos:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS`
** [NextToken](#API_GetDocumentTextDetection_ResponseSyntax) **
Si la respuesta se trunca, Amazon Textract devuelve este token. Puede utilizar este token en la solicitud subsiguiente para recuperar el siguiente conjunto de resultados de detección de texto.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón: `.*\S.*`
** [StatusMessage](#API_GetDocumentTextDetection_ResponseSyntax) **
Devuelve si el trabajo de detección no se ha podido completar. Contiene explicación de qué error se ha producido.
Type: Cadena
** [Warnings](#API_GetDocumentTextDetection_ResponseSyntax) **
Lista de advertencias que se produjeron durante la operación de detección de texto del documento.
Type: Matrices de[Warning](API_Warning.md)objects
## Errores
** AccessDeniedException **
No tiene autorización para realizar la acción. Utilice el nombre de recurso de Amazon (ARN) de un usuario autorizado o un rol de IAM para realizar la operación.
Código de estado HTTP: 400
** InternalServerError **
Amazon Textract ha tenido un problema de servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** InvalidJobIdException **
Se ha pasado un identificador de trabajo no válido a[GetDocumentAnalysis](API_GetDocumentAnalysis.md)o para[GetDocumentAnalysis](API_GetDocumentAnalysis.md).
Código de estado HTTP: 400
** InvalidKMSKeyException **
Indica que no tiene permisos de descifrado con la clave KMS introducida o que la clave KMS se ha introducido de forma incorrecta.
Código de estado HTTP: 400
** InvalidParameterException **
Un parámetro de entrada infringió una restricción. Por ejemplo, en operaciones sincrónicas, un`InvalidParameterException`se produce cuando ninguno de los`S3Object`o`Bytes`los valores se proporcionan en el`Document`parámetro de solicitud. Valide el parámetro antes de llamar a la operación de la API de nuevo.
Código de estado HTTP: 400
** InvalidS3ObjectException **
Amazon Textract Texact no puede obtener acceso al objeto de S3 especificado en la solicitud. Para obtener más información,[Configuración del acceso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obtener información sobre la resolución de problemas, consulte[Solución de problemas de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Código de estado HTTP: 400
** ProvisionedThroughputExceededException **
El número de solicitudes ha superado su límite de rendimiento. Si quieres aumentar este límite, ponte en contacto con Amazon Textract.
Código de estado HTTP: 400
** ThrottlingException **
Amazon Textract Texact no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetDocumentTextDetection)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetDocumentTextDetection)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetDocumentTextDetection)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetDocumentTextDetection)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetDocumentTextDetection)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetDocumentTextDetection)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetDocumentTextDetection)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetDocumentTextDetection)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetDocumentTextDetection)
# GetExpenseAnalysis
Obtiene los resultados de una operación asíncrona de Amazon Textract que analiza facturas y recibos. Amazon Textract encuentra la información de contacto, los artículos comprados y el nombre del proveedor, a partir de facturas y recibos de entrada.
Para iniciar un análisis asíncrono de factura/recibo llamando[StartExpenseAnalysis](API_StartExpenseAnalysis.md), que devuelve un identificador de trabajo (`JobId`). Una vez completado el análisis de factura/recepción, Amazon Textract publica el estado de realización en el tema de Amazon Simple Notification Service (Amazon SNS). Este tema debe registrarse en la llamada inicial a`StartExpenseAnalysis`. Para obtener los resultados de la operación de análisis de factura/recepción, en primer lugar, asegúrese de que el valor de estado publicado en el tema de Amazon SNS es`SUCCEEDED`. Si es así, llame`GetExpenseAnalysis`y pasa el identificador de trabajo (`JobId`) desde la llamada inicial hasta`StartExpenseAnalysis`.
Utilice el parámetro MaxResults para limitar el número de bloques devueltos. Si hay más resultados de los especificados en`MaxResults`, el valor de`NextToken`en la respuesta de operación contiene un token de paginación para obtener el siguiente conjunto de resultados. Para obtener la siguiente página de resultados, llame`GetExpenseAnalysis`, y rellénela`NextToken`parámetro request con el valor de token que se devuelve de la llamada anterior a`GetExpenseAnalysis`.
Para obtener más información, consulte[Análisis de facturas y recibos](https://docs.aws.amazon.com/textract/latest/dg/invoices-receipts.html).
## Sintaxis de la solicitud
```
{
"JobId": "string",
"MaxResults": number,
"NextToken": "string"
}
```
## Parámetros de solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [JobId](#API_GetExpenseAnalysis_RequestSyntax) **
Un identificador único para el trabajo de detección de texto. La`JobId`se devuelve desde`StartExpenseAnalysis`. UNA`JobId`El valor solo es válido durante 7 días.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `^[a-zA-Z0-9-_]+$`
Obligatorio: Sí
** [MaxResults](#API_GetExpenseAnalysis_RequestSyntax) **
El número máximo de resultados que devolver por llamada paginada. El valor más grande que puede especificar es 20. Si especifica un valor superior a 20, se devolverá un máximo de 20 resultados. El valor predeterminado es 20.
Type: Entero
Rango válido: Valor mínimo de 1.
Obligatorio: No
** [NextToken](#API_GetExpenseAnalysis_RequestSyntax) **
Si la respuesta anterior estaba incompleta (porque hay más bloques que recuperar), Amazon Texact devuelve un token de paginación en la respuesta. Puede utilizar este token de paginación para recuperar el siguiente conjunto de bloques.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón: `.*\S.*`
Obligatorio: No
## Sintaxis de la respuesta
```
{
"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 ]
}
]
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [AnalyzeExpenseModelVersion](#API_GetExpenseAnalysis_ResponseSyntax) **
La versión del modelo actual de AnalyzeExpense.
Type: Cadena
** [DocumentMetadata](#API_GetExpenseAnalysis_ResponseSyntax) **
Información sobre un documento que Amazon Textract procesó.`DocumentMetadata`se devuelve en cada página de respuestas paginadas de una operación de Amazon Textract Texact.
Tipo: objeto [DocumentMetadata](API_DocumentMetadata.md)
** [ExpenseDocuments](#API_GetExpenseAnalysis_ResponseSyntax) **
Los gastos detectados por Amazon Textract.
Type: Matriz de[ExpenseDocument](API_ExpenseDocument.md)objects
** [JobStatus](#API_GetExpenseAnalysis_ResponseSyntax) **
El estado actual del trabajo de detección de texto.
Type: Cadena
Valores válidos:` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS`
** [NextToken](#API_GetExpenseAnalysis_ResponseSyntax) **
Si la respuesta se trunca, Amazon Textract devuelve este token. Puede utilizar este token en la solicitud subsiguiente para recuperar el siguiente conjunto de resultados de detección de texto.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 255 caracteres.
Patrón: `.*\S.*`
** [StatusMessage](#API_GetExpenseAnalysis_ResponseSyntax) **
Devuelve si el trabajo de detección no se ha podido completar. Contiene explicación de qué error se ha producido.
Type: Cadena
** [Warnings](#API_GetExpenseAnalysis_ResponseSyntax) **
Lista de advertencias que se produjeron durante la operación de detección de texto del documento.
Type: Matriz de[Warning](API_Warning.md)objects
## Errores
** AccessDeniedException **
No tiene autorización para realizar la acción. Utilice el nombre de recurso de Amazon (ARN) de un usuario autorizado o un rol de IAM para realizar la operación.
Código de estado HTTP: 400
** InternalServerError **
Amazon Textract ha tenido un problema de servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** InvalidJobIdException **
Se ha pasado un identificador de trabajo no válido a[GetDocumentAnalysis](API_GetDocumentAnalysis.md)o para[GetDocumentAnalysis](API_GetDocumentAnalysis.md).
Código de estado HTTP: 400
** InvalidKMSKeyException **
Indica que no tiene permisos de descifrado con la clave KMS introducida o que la clave KMS se ha introducido de forma incorrecta.
Código de estado HTTP: 400
** InvalidParameterException **
Un parámetro de entrada infringió una restricción. Por ejemplo, en operaciones sincrónicas, un`InvalidParameterException`se produce cuando ninguno de los`S3Object`o`Bytes`los valores se proporcionan en el`Document`parámetro de solicitud. Valide el parámetro antes de llamar a la operación de la API de nuevo.
Código de estado HTTP: 400
** InvalidS3ObjectException **
Amazon Textract Texact no puede obtener acceso al objeto de S3 especificado en la solicitud. Para obtener más información,[Configuración del acceso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obtener información sobre la resolución de problemas, consulte[Solución de problemas de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Código de estado HTTP: 400
** ProvisionedThroughputExceededException **
El número de solicitudes ha superado su límite de rendimiento. Si quieres aumentar este límite, ponte en contacto con Amazon Textract.
Código de estado HTTP: 400
** ThrottlingException **
Amazon Textract Texact no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/GetExpenseAnalysis)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetExpenseAnalysis)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetExpenseAnalysis)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetExpenseAnalysis)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetExpenseAnalysis)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetExpenseAnalysis)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetExpenseAnalysis)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetExpenseAnalysis)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetExpenseAnalysis)
# StartDocumentAnalysis
Inicia el análisis asíncrono de un documento de entrada para detectar las relaciones entre elementos detectados como pares clave-valor, tablas y elementos de selección.
`StartDocumentAnalysis`puede analizar el texto de documentos en formato JPEG, PNG, TIFF y PDF. Los documentos se almacenan en un bucket de Amazon S3. Usar[DocumentLocation](API_DocumentLocation.md)para especificar el nombre del bucket de y el nombre de archivo del documento.
`StartDocumentAnalysis`devuelve un identificador de trabajo (`JobId`) que utiliza para obtener los resultados de la operación. Cuando el análisis de texto se finalice, Amazon Textract Texact publica un estado de finalización en el tema de Amazon Simple Notification Service (Amazon SNS) que especifique en`NotificationChannel`. Para obtener los resultados de la operación de análisis de texto, compruebe primero que el valor de estado publicado en el tema de Amazon SNS es`SUCCEEDED`. Si es así, llame[GetDocumentAnalysis](API_GetDocumentAnalysis.md)y pasa el identificador de trabajo (`JobId`) desde la llamada inicial hasta`StartDocumentAnalysis`.
Para obtener más información, consulte[Análisis de texto en documentos](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-analyzing.html).
## Sintaxis de la solicitud
```
{
"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"
}
}
```
## Parámetros de solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [ClientRequestToken](#API_StartDocumentAnalysis_RequestSyntax) **
El token idempotente que utiliza para identificar la solicitud de inicio. Si utilizas el mismo token con varios`StartDocumentAnalysis`solicitudes, lo mismo`JobId`se devuelve. Usar`ClientRequestToken`para evitar que el mismo trabajo se inicie accidentalmente más de una vez. Para obtener más información, consulte[Llamar a operaciones asíncronas de Amazon Textract](https://docs.aws.amazon.com/textract/latest/dg/api-async.html).
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `^[a-zA-Z0-9-_]+$`
Obligatorio: No
** [DocumentLocation](#API_StartDocumentAnalysis_RequestSyntax) **
Ubicación del documento que se va a procesar.
Tipo: objeto [DocumentLocation](API_DocumentLocation.md)
Obligatorio: Sí
** [FeatureTypes](#API_StartDocumentAnalysis_RequestSyntax) **
Lista de los tipos de análisis que se van a realizar. Agregue TABLES a la lista para devolver información sobre las tablas detectadas en el documento de entrada. Añada FORMULARIOS para devolver los datos del formulario detectados. Para realizar ambos tipos de análisis, agregue TABLES y FORMS a`FeatureTypes`. Todas las líneas y palabras detectadas en el documento se incluyen en la respuesta (incluido el texto que no está relacionado con el valor de`FeatureTypes`).
Type: Matriz de cadenas
Valores válidos:` TABLES | FORMS`
Obligatorio: Sí
** [JobTag](#API_StartDocumentAnalysis_RequestSyntax) **
Identificador que especifique incluido en la notificación de finalización publicada en el tema de Amazon SNS. Por ejemplo, puede utilizar`JobTag`para identificar el tipo de documento al que corresponde la notificación de finalización (como un formulario fiscal o un recibo).
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `[a-zA-Z0-9_.\-:]+`
Obligatorio: No
** [KMSKeyId](#API_StartDocumentAnalysis_RequestSyntax) **
La clave KMS utilizada para cifrar los resultados de inferencia. Puede estar en formato ID de clave o alias de clave. Cuando se proporciona una clave KMS, la clave KMS se utilizará para el cifrado del lado del servidor de los objetos del depósito de clientes. Cuando este parámetro no está habilitado, el resultado se cifrará en el lado del servidor mediante SSE-S3.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$`
Obligatorio: No
** [NotificationChannel](#API_StartDocumentAnalysis_RequestSyntax) **
Arn del tema de Amazon SNS en el que desea que Amazon Textract publique el estado de finalización de la operación.
Tipo: objeto [NotificationChannel](API_NotificationChannel.md)
Obligatorio: No
** [OutputConfig](#API_StartDocumentAnalysis_RequestSyntax) **
Establece si la salida irá a un depósito definido por el cliente. De forma predeterminada, Amazon Textract Texact guardará los resultados internamente para acceder a ellos mediante la operación GetDocumentAnalysis.
Tipo: objeto [OutputConfig](API_OutputConfig.md)
Obligatorio: No
## Sintaxis de la respuesta
```
{
"JobId": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [JobId](#API_StartDocumentAnalysis_ResponseSyntax) **
El identificador del trabajo de detección de texto en documentos. Usar`JobId`para identificar el trabajo en una llamada posterior a`GetDocumentAnalysis`. UNA`JobId`El valor es válido solo durante 7 días.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `^[a-zA-Z0-9-_]+$`
## Errores
** AccessDeniedException **
No tiene autorización para realizar la acción. Utilice el nombre de recurso de Amazon (ARN) de un usuario autorizado o un rol de IAM para realizar la operación.
Código de estado HTTP: 400
** BadDocumentException **
Amazon Textract Texact no puede leer el documento. Para obtener más información sobre los límites de documentos en Amazon Textract, consulte[Límites máximos de Amazon Textract](limits.md).
Código de estado HTTP: 400
** DocumentTooLargeException **
El documento no se puede procesar porque es demasiado grande. Tamaño máximo de documento para operaciones síncronas de 10 MB. El tamaño máximo de documento para operaciones asíncronas es de 500 MB para los archivos PDF.
Código de estado HTTP: 400
** IdempotentParameterMismatchException **
UNA`ClientRequestToken`Se ha reutilizado con una operación, pero al menos uno de los demás parámetros de entrada es distinto de la llamada anterior a la operación.
Código de estado HTTP: 400
** InternalServerError **
Amazon Textract ha tenido un problema de servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** InvalidKMSKeyException **
Indica que no tiene permisos de descifrado con la clave KMS introducida o que la clave KMS se ha introducido de forma incorrecta.
Código de estado HTTP: 400
** InvalidParameterException **
Un parámetro de entrada infringió una restricción. Por ejemplo, en operaciones sincrónicas, un`InvalidParameterException`se produce cuando ninguno de los`S3Object`o`Bytes`los valores se proporcionan en el`Document`parámetro de solicitud. Valide el parámetro antes de llamar a la operación de la API de nuevo.
Código de estado HTTP: 400
** InvalidS3ObjectException **
Amazon Textract no puede obtener acceso al objeto de S3 que se especifica en la solicituda. para obtener más información,[Configuración del acceso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obtener información sobre la resolución de problemas, consulte[Solución de problemas de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Código de estado HTTP: 400
** LimitExceededException **
Se ha superado un límite de servicio Amazon Textract. Por ejemplo, si inicia demasiados trabajos asíncronos simultáneamente, llama para iniciar operaciones (`StartDocumentTextDetection`, por ejemplo) produce una excepción LimitExceededException (código de estado HTTP: 400) hasta que el número de trabajos ejecutados simultáneamente se encuentre por debajo del límite de servicio Amazon Textract Texacte.
Código de estado HTTP: 400
** ProvisionedThroughputExceededException **
El número de solicitudes ha superado su límite de rendimiento. Si necesita aumentar este límite, póngase en contacto con Amazon Textract.
Código de estado HTTP: 400
** ThrottlingException **
Amazon Textract Texact no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** UnsupportedDocumentException **
No se admite el formato del documento de entrada. Los documentos para operaciones pueden estar en formato PNG, JPEG, PDF o TIFF.
Código de estado HTTP: 400
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartDocumentAnalysis)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartDocumentAnalysis)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartDocumentAnalysis)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartDocumentAnalysis)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartDocumentAnalysis)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartDocumentAnalysis)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartDocumentAnalysis)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartDocumentAnalysis)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartDocumentAnalysis)
# StartDocumentTextDetection
Comienza la detección asincrónica del texto de un documento. Amazon Textract Texact puede detectar líneas de texto y las palabras que componen una línea de texto.
`StartDocumentTextDetection`puede analizar el texto de documentos en formato JPEG, PNG, TIFF y PDF. Los documentos se almacenan en un bucket de Amazon S3. Usar[DocumentLocation](API_DocumentLocation.md)para especificar el nombre del bucket de y el nombre de archivo del documento.
`StartTextDetection`devuelve un identificador de trabajo (`JobId`) que utiliza para obtener los resultados de la operación. Una vez finalizada la detección de texto, Amazon Textract publica un estado de finalización en el tema Amazon Simple Notification Service (Amazon SNS) que especifique en`NotificationChannel`. Para obtener los resultados de la operación de detección de texto, compruebe primero que el valor de estado publicado en el tema de Amazon SNS es`SUCCEEDED`. Si es así, llame[GetDocumentTextDetection](API_GetDocumentTextDetection.md)y pasa el identificador de trabajo (`JobId`) desde la llamada inicial hasta`StartDocumentTextDetection`.
Para obtener más información, consulte[Detección de texto de documentos](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html).
## Sintaxis de la solicitud
```
{
"ClientRequestToken": "string",
"DocumentLocation": {
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
},
"JobTag": "string",
"KMSKeyId": "string",
"NotificationChannel": {
"RoleArn": "string",
"SNSTopicArn": "string"
},
"OutputConfig": {
"S3Bucket": "string",
"S3Prefix": "string"
}
}
```
## Parámetros de solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [ClientRequestToken](#API_StartDocumentTextDetection_RequestSyntax) **
El token idempotente que se utiliza para identificar la solicitud de inicio. Si utilizas el mismo token con varios`StartDocumentTextDetection`solicitudes, lo mismo`JobId`se devuelve. Usar`ClientRequestToken`para evitar que el mismo trabajo se inicie accidentalmente más de una vez. Para obtener más información, consulte[Llamar a operaciones asíncronas de Amazon Textract](https://docs.aws.amazon.com/textract/latest/dg/api-async.html).
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `^[a-zA-Z0-9-_]+$`
Obligatorio: No
** [DocumentLocation](#API_StartDocumentTextDetection_RequestSyntax) **
Ubicación del documento que se va a procesar.
Tipo: objeto [DocumentLocation](API_DocumentLocation.md)
Obligatorio: Sí
** [JobTag](#API_StartDocumentTextDetection_RequestSyntax) **
Identificador que especifique que se incluye en la notificación de finalización publicada en el tema de Amazon SNS. Por ejemplo, puede utilizar`JobTag`para identificar el tipo de documento al que corresponde la notificación de finalización (como un formulario fiscal o un recibo).
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `[a-zA-Z0-9_.\-:]+`
Obligatorio: No
** [KMSKeyId](#API_StartDocumentTextDetection_RequestSyntax) **
La clave KMS utilizada para cifrar los resultados de inferencia. Puede estar en formato ID de clave o alias de clave. Cuando se proporciona una clave KMS, la clave KMS se utilizará para el cifrado del lado del servidor de los objetos del depósito de clientes. Cuando este parámetro no está habilitado, el resultado se cifrará en el lado del servidor mediante SSE-S3.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$`
Obligatorio: No
** [NotificationChannel](#API_StartDocumentTextDetection_RequestSyntax) **
Arn del tema de Amazon SNS en el que desea que Amazon Textract publique el estado de finalización de la operación.
Tipo: objeto [NotificationChannel](API_NotificationChannel.md)
Obligatorio: No
** [OutputConfig](#API_StartDocumentTextDetection_RequestSyntax) **
Establece si la salida va a ir a un depósito definido por el cliente. De forma predeterminada, Amazon Textract Texact guardará los resultados internamente para acceder a ellos con la operación GetDocumentTextDetection.
Tipo: objeto [OutputConfig](API_OutputConfig.md)
Obligatorio: No
## Sintaxis de la respuesta
```
{
"JobId": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [JobId](#API_StartDocumentTextDetection_ResponseSyntax) **
Identificador del trabajo de detección de texto del documento. Usar`JobId`para identificar el trabajo en una llamada posterior a`GetDocumentTextDetection`. UNA`JobId`El valor solo es válido durante 7 días.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `^[a-zA-Z0-9-_]+$`
## Errores
** AccessDeniedException **
No tiene autorización para realizar la acción. Utilice el nombre de recurso de Amazon (ARN) de un usuario autorizado o un rol de IAM para realizar la operación.
Código de estado HTTP: 400
** BadDocumentException **
Amazon Textract Texact no puede leer el documento. Para obtener más información sobre los límites de documentos en Amazon Textract, consulte[Límites máximos de Amazon Textract](limits.md).
Código de estado HTTP: 400
** DocumentTooLargeException **
El documento no se puede procesar porque es demasiado grande. Tamaño máximo de documento para operaciones síncronas de 10 MB. El tamaño máximo de documento para las operaciones asíncronas es de 500 MB para los archivos PDF.
Código de estado HTTP: 400
** IdempotentParameterMismatchException **
UNA`ClientRequestToken`se ha reutilizado con una operación, pero al menos uno de los demás parámetros de entrada es distinto de la llamada anterior a la operación.
Código de estado HTTP: 400
** InternalServerError **
Amazon Textract ha tenido un problema de servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** InvalidKMSKeyException **
Indica que no tiene permisos de descifrado con la clave KMS introducida o que la clave KMS se ha introducido de forma incorrecta.
Código de estado HTTP: 400
** InvalidParameterException **
Un parámetro de entrada infringió una restricción. Por ejemplo, en operaciones sincrónicas, un`InvalidParameterException`se produce cuando ninguno de los`S3Object`o`Bytes`los valores se proporcionan en el`Document`parámetro de solicitud. Valide el parámetro antes de llamar a la operación de la API de nuevo.
Código de estado HTTP: 400
** InvalidS3ObjectException **
Amazon Textract Texact no puede obtener acceso al objeto de S3 que se especifica en la solicitud. Para obtener más información,[Configuración del acceso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obtener información sobre la resolución de problemas, consulte[Solución de problemas de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Código de estado HTTP: 400
** LimitExceededException **
Se ha superado un límite de servicio Amazon Textract. Por ejemplo, si inicia demasiados trabajos asíncronos simultáneamente, llama para iniciar operaciones (`StartDocumentTextDetection`, por ejemplo) produce una excepción de LimitExceededException (código de estado HTTP: 400) hasta que el número de trabajos ejecutados simultáneamente se encuentre por debajo del límite de servicio Amazon Textract.
Código de estado HTTP: 400
** ProvisionedThroughputExceededException **
El número de solicitudes ha superado su límite de rendimiento. Si necesita aumentar este límite, póngase en contacto con Amazon Textract.
Código de estado HTTP: 400
** ThrottlingException **
Amazon Textract Texact no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** UnsupportedDocumentException **
No se admite el formato del documento de entrada. Los documentos para operaciones pueden estar en formato PNG, JPEG, PDF o TIFF.
Código de estado HTTP: 400
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartDocumentTextDetection)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartDocumentTextDetection)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartDocumentTextDetection)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartDocumentTextDetection)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartDocumentTextDetection)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartDocumentTextDetection)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartDocumentTextDetection)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartDocumentTextDetection)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartDocumentTextDetection)
# StartExpenseAnalysis
Inicia el análisis asíncrono de facturas o recibos de datos como información de contacto, artículos comprados y nombres de proveedores.
`StartExpenseAnalysis`puede analizar el texto de documentos en formato JPEG, PNG y PDF. Los documentos deben almacenarse en un bucket de Amazon S3. Usar[DocumentLocation](API_DocumentLocation.md)para especificar el nombre del bucket de S3 y el nombre del documento de ese bucket.
`StartExpenseAnalysis`devuelve un identificador de trabajo (`JobId`) que proporcionarás a`GetExpenseAnalysis`para recuperar los resultados de la operación. Cuando finaliza el análisis de las facturas/recibos de entrada, Amazon Textract publica un estado de finalización en el tema Amazon Simple Notification Service (Amazon SNS) que proporciona al`NotificationChannel`. Para obtener los resultados de la operación de análisis de facturas y recibos, asegúrese de que el valor de estado publicado en el tema de Amazon SNS sea`SUCCEEDED`. Si es así, llame[GetExpenseAnalysis](API_GetExpenseAnalysis.md)y pasa el identificador de trabajo (`JobId`) que se devolvió mediante tu llamada a`StartExpenseAnalysis`.
Para obtener más información, consulte[Análisis de facturas y recibos](https://docs.aws.amazon.com/textract/latest/dg/invoice-receipts.html).
## Sintaxis de la solicitud
```
{
"ClientRequestToken": "string",
"DocumentLocation": {
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
},
"JobTag": "string",
"KMSKeyId": "string",
"NotificationChannel": {
"RoleArn": "string",
"SNSTopicArn": "string"
},
"OutputConfig": {
"S3Bucket": "string",
"S3Prefix": "string"
}
}
```
## Parámetros de solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [ClientRequestToken](#API_StartExpenseAnalysis_RequestSyntax) **
El token idempotente que se utiliza para identificar la solicitud de inicio. Si utilizas el mismo token con varios`StartDocumentTextDetection`solicitudes, lo mismo`JobId`se devuelve. Usar`ClientRequestToken`para evitar que el mismo trabajo se inicie accidentalmente más de una vez. Para obtener más información, consulte[Llamar a operaciones asíncronas de Amazon Textract](https://docs.aws.amazon.com/textract/latest/dg/api-async.html)
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `^[a-zA-Z0-9-_]+$`
: obligatorio No
** [DocumentLocation](#API_StartExpenseAnalysis_RequestSyntax) **
Ubicación del documento que se va a procesar.
Tipo: objeto [DocumentLocation](API_DocumentLocation.md)
: obligatorio Sí
** [JobTag](#API_StartExpenseAnalysis_RequestSyntax) **
Identificador que especifique que se incluye en la notificación de finalización publicada en el tema de Amazon SNS. Por ejemplo, puede utilizar`JobTag`para identificar el tipo de documento al que corresponde la notificación de finalización (como un formulario fiscal o un recibo).
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `[a-zA-Z0-9_.\-:]+`
: obligatorio No
** [KMSKeyId](#API_StartExpenseAnalysis_RequestSyntax) **
La clave KMS utilizada para cifrar los resultados de la inferencia. Puede estar en formato ID de clave o alias de clave. Cuando se proporciona una clave KMS, la clave KMS se utilizará para el cifrado del lado del servidor de los objetos del depósito de clientes. Cuando este parámetro no está habilitado, el resultado se cifrará en el lado del servidor mediante SSE-S3.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$`
: obligatorio No
** [NotificationChannel](#API_StartExpenseAnalysis_RequestSyntax) **
Arn del tema de Amazon SNS en el que desea que Amazon Textract publique el estado de finalización de la operación.
Tipo: objeto [NotificationChannel](API_NotificationChannel.md)
: obligatorio No
** [OutputConfig](#API_StartExpenseAnalysis_RequestSyntax) **
Establece si la salida va a ir a un depósito definido por el cliente. De forma predeterminada, Amazon Textract Texact guardará los resultados internamente para que pueda acceder a ellos`GetExpenseAnalysis`.
Tipo: objeto [OutputConfig](API_OutputConfig.md)
: obligatorio No
## Sintaxis de la respuesta
```
{
"JobId": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [JobId](#API_StartExpenseAnalysis_ResponseSyntax) **
Un identificador único del trabajo de detección de texto. La`JobId`se devuelve desde`StartExpenseAnalysis`. UNA`JobId`El valor solo es válido durante 7 días.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es 64.
Patrón: `^[a-zA-Z0-9-_]+$`
## Errores
** AccessDeniedException **
No tiene autorización para realizar la acción. Utilice el nombre de recurso de Amazon (ARN) de un usuario autorizado o un rol de IAM para realizar la operación.
Código de estado HTTP: 400
** BadDocumentException **
Amazon Textract Texact no puede leer el documento. Para obtener más información sobre los límites de documentos en Amazon Textract, consulte[Límites máximos de Amazon Textract](limits.md).
Código de estado HTTP: 400
** DocumentTooLargeException **
El documento no se puede procesar porque es demasiado grande. Tamaño máximo de documento para operaciones síncronas de 10 MB. El tamaño máximo de documento para las operaciones asíncronas es de 500 MB para los archivos PDF.
Código de estado HTTP: 400
** IdempotentParameterMismatchException **
UNA`ClientRequestToken`Se ha reutilizado con una operación, pero al menos uno de los demás parámetros de entrada es distinto de la llamada anterior a la operación.
Código de estado HTTP: 400
** InternalServerError **
Amazon Textract ha tenido un problema de servicio. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** InvalidKMSKeyException **
Indica que no tiene permisos de descifrado con la clave KMS introducida o que la clave KMS se ha introducido de forma incorrecta.
Código de estado HTTP: 400
** InvalidParameterException **
Un parámetro de entrada infringió una restricción. Por ejemplo, en operaciones sincrónicas, un`InvalidParameterException`se produce cuando ninguno de los`S3Object`o`Bytes`los valores se proporcionan en el`Document`parámetro de solicitud. Valide el parámetro antes de llamar a la operación de la API de nuevo.
Código de estado HTTP: 400
** InvalidS3ObjectException **
Amazon Textract Texact no puede obtener acceso al objeto de S3 especificado en la solicitud. Para obtener más información,[Configuración del acceso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Para obtener información sobre la resolución de problemas, consulte[Solución de problemas de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Código de estado HTTP: 400
** LimitExceededException **
Se ha superado un límite de servicio de Amazon Texact. Por ejemplo, si inicia demasiados trabajos asíncronos simultáneamente, llama para iniciar operaciones (`StartDocumentTextDetection`, por ejemplo) produce una excepción LimitExceededException (código de estado HTTP: 400) hasta que el número de trabajos ejecutados simultáneamente se encuentre por debajo del límite de servicio de Amazon Textract.
Código de estado HTTP: 400
** ProvisionedThroughputExceededException **
El número de solicitudes ha superado su límite de rendimiento. Si necesita aumentar este límite, póngase en contacto con Amazon Textract.
Código de estado HTTP: 400
** ThrottlingException **
Amazon Textract Texact no puede procesar temporalmente la solicitud. Pruebe la llamada de nuevo.
Código de estado HTTP: 500
** UnsupportedDocumentException **
No se admite el formato del documento de entrada. Los documentos para operaciones pueden estar en formato PNG, JPEG, PDF o TIFF.
Código de estado HTTP: 400
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartExpenseAnalysis)
+ [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartExpenseAnalysis)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartExpenseAnalysis)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartExpenseAnalysis)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartExpenseAnalysis)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartExpenseAnalysis)
+ [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartExpenseAnalysis)
+ [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartExpenseAnalysis)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartExpenseAnalysis)
# Tipos de datos
Los tipos de datos siguientes son compatibles:
+ [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
Se utiliza para contener la información detectada por una operación AnalyzeID.
## Contenido
** Confidence **
La puntuación de confianza del texto detectado.
Type: Float
Rango válido: Valor mínimo de 0. Valor máximo de 100.
Obligatorio: No
** NormalizedValue **
Solo se devuelve para fechas, devuelve el tipo de valor detectado y la fecha escrita de forma más legible por máquina.
Tipo: objeto [NormalizedValue](API_NormalizedValue.md)
Obligatorio: No
** Text **
Texto del campo normalizado o del valor asociado a él.
Type: Cadena
Obligatorio: Sí
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeIDDetections)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeIDDetections)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeIDDetections)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeIDDetections)
# Block
UNA`Block`representa elementos que se reconocen en un documento dentro de un grupo de píxeles cerca uno del otro. La información devuelta en un`Block`depende del tipo de operación. Detección de texto para documentos (por ejemplo[DetectDocumentText](API_DetectDocumentText.md)), obtendrá información sobre las palabras y líneas de texto detectadas. En el análisis de texto (por ejemplo[AnalyzeDocument](API_AnalyzeDocument.md)), también puede obtener información sobre los campos, tablas y elementos de selección detectados en el documento.
Una matriz de`Block`los objetos se devuelven mediante operaciones síncronas y asíncronas. En operaciones sincrónicas, tales como[DetectDocumentText](API_DetectDocumentText.md), la matriz de`Block`objetos es todo el conjunto de resultados. En operaciones asíncronas, tales como[GetDocumentAnalysis](API_GetDocumentAnalysis.md), la matriz se devuelve a lo largo de una o más respuestas.
Para obtener más información, consulte[Funcionamiento de Amazon Textract](https://docs.aws.amazon.com/textract/latest/dg/how-it-works.html).
## Contenido
** BlockType **
El tipo de elemento de texto que se reconoce. En las operaciones de detección de texto, se devuelven los siguientes tipos:
+ *PÁGINA*- Contiene una lista de la línea`Block`objetos detectados en una página de documento.
+ *PALABRA*- Palabra detectada en una página de documento. Una palabra consta de uno o varios caracteres en alfabeto latino básico ISO que no están separados por espacios.
+ *LÍNEA*- Una cadena de palabras contiguas delimitadas por tabuladores que se detectan en una página de documento.
En las operaciones de análisis de texto, se devuelven los siguientes tipos:
+ *PÁGINA*- Contiene una lista de niños`Block`objetos detectados en una página de documento.
+ *KEY\$1VALUE\$1SET*- Almacena la CLAVE y el VALOR`Block`objetos para texto vinculado que se detecta en una página de documento. Usar`EntityType`para determinar si un objeto KEY\$1VALUE\$1SET es KEY`Block`objeto o VALUE`Block`objeto.
+ *PALABRA*- Palabra que se detecta en una página de documento. Una palabra consta de uno o varios caracteres en alfabeto latino básico ISO que no están separados por espacios.
+ *LÍNEA*- Una cadena de palabras contiguas delimitadas por tabuladores que se detectan en una página de documento.
+ *TABLA*- Tabla que se detecta en una página de documento. Una tabla es información basada en cuadrícula con dos o más filas o columnas, con un rango de celdas de una fila y una columna cada una.
+ *CELDA*- Una celda dentro de una tabla detectada. La celda es el padre del bloque que contiene el texto de la celda.
+ *SELECTION\$1ELEMENT*- Elemento de selección, como un botón de opción (botón de opción) o una casilla de verificación detectada en una página de documento. Utilice el valor de`SelectionStatus`para determinar el estado del elemento de selección.
Type: Cadena
Valores válidos:` KEY_VALUE_SET | PAGE | LINE | WORD | TABLE | CELL | SELECTION_ELEMENT`
Obligatorio: No
** ColumnIndex **
Columna en la que aparece una celda de tabla. La primera posición de columna es 1.`ColumnIndex`no es devuelto por`DetectDocumentText`y`GetDocumentTextDetection`.
Type: Entero
Rango válido: Valor mínimo de 0.
Obligatorio: No
** ColumnSpan **
El número de columnas que abarca una celda de tabla. Actualmente, este valor es siempre 1, incluso si el número de columnas extendidas es mayor que 1.`ColumnSpan`no es devuelto por`DetectDocumentText`y`GetDocumentTextDetection`.
Type: Entero
Rango válido: Valor mínimo de 0.
Obligatorio: No
** Confidence **
La puntuación de confianza que tiene Amazon Textract Texact en la exactitud del texto reconocido y la precisión de los puntos de geometría alrededor del texto reconocido.
Type: Float
Rango válido: Valor mínimo de 0. Valor máximo de 100.
Obligatorio: No
** EntityTypes **
El tipo de entidad. Se puede devolver lo siguiente:
+ *CLAVE*- Identificador de un campo del documento.
+ *VALUE*- El texto del campo.
`EntityTypes`no es devuelto por`DetectDocumentText`y`GetDocumentTextDetection`.
Type: Matriz de cadenas
Valores válidos:` KEY | VALUE`
Obligatorio: No
** Geometry **
La ubicación del texto reconocido en la imagen. Incluye un cuadro delimitador grueso alineado con ejes que rodea el texto y un polígono de grano fino para obtener información espacial más precisa.
Tipo: objeto [Geometry](API_Geometry.md)
Obligatorio: No
** Id **
Identificador del texto reconocido. El identificador solo es exclusivo para una sola operación.
Type: Cadena
Patrón: `.*\S.*`
Obligatorio: No
** Page **
Página en la que se ha detectado un bloque.`Page`se devuelve mediante operaciones asíncronas. Los valores de página superiores a 1 solo se devuelven para documentos de varias páginas en formato PDF o TIFF. Una imagen escaneada (JPEG/PNG), aunque contenga varias páginas de documentos, se considera un documento de una sola página. El valor de`Page`es siempre 1. Las operaciones sincrónicas no regresan`Page`porque cada documento de entrada se considera un documento de una sola página.
Type: Entero
Rango válido: Valor mínimo de 0.
Obligatorio: No
** Relationships **
Lista de bloques secundarios del bloque actual. Por ejemplo, un objeto LINE tiene bloques secundarios para cada bloque WORD que forma parte de la línea de texto. No hay objetos Relationship en la lista para relaciones que no existen, como cuando el bloque actual no tiene bloques secundarios. El tamaño de la lista puede ser el siguiente:
+ 0 - El bloque no tiene bloques secundarios.
+ 1 - El bloque tiene bloques secundarios.
Type: Matriz de[Relationship](API_Relationship.md)objects
Obligatorio: No
** RowIndex **
Fila en la que se encuentra una celda de tabla. La primera posición de la fila es 1.`RowIndex`no es devuelto por`DetectDocumentText`y`GetDocumentTextDetection`.
Type: Entero
Rango válido: Valor mínimo de 0.
Obligatorio: No
** RowSpan **
El número de filas que abarca una celda de tabla. Actualmente, este valor es siempre 1, incluso si el número de filas extendidas es mayor que 1.`RowSpan`no es devuelto por`DetectDocumentText`y`GetDocumentTextDetection`.
Type: Entero
Rango válido: Valor mínimo de 0.
Obligatorio: No
** SelectionStatus **
El estado de selección de un elemento de selección, como un botón de opción o una casilla de verificación.
Type: Cadena
Valores válidos:` SELECTED | NOT_SELECTED`
Obligatorio: No
** Text **
La palabra o línea de texto reconocida por Amazon Textract.
Type: Cadena
Obligatorio: No
** TextType **
El tipo de texto que Amazon Textract ha detectado. Puede comprobar si hay texto escrito a mano y texto impreso.
Type: Cadena
Valores válidos:` HANDWRITING | PRINTED`
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Block)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Block)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Block)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Block)
# BoundingBox
Cuadro delimitador alrededor de la página, texto, par clave-valor, tabla, celda de tabla o elemento de selección detectados en una página de documento. La`left`(coordenada x) y`top`(coordenada y) son coordenadas que representan los lados superior e izquierdo del cuadro delimitador. Observe que la esquina superior izquierda de la imagen es el origen (0,0).
La`top`y`left`los valores devueltos son proporciones del tamaño total de página del documento. Por ejemplo, si la imagen de entrada es de 700 x 200 píxeles y la coordenada superior izquierda del cuadro delimitador es de 350 x 50 píxeles, la API devuelve un valor de `left` de 0,5 (350/700) y un valor de `top` de 0,25 (50/200).
La`width`y`height`Los valores representan las dimensiones del cuadro delimitador expresada proporcional respecto a la dimensión total de la página del documento. Por ejemplo, si el tamaño de página del documento es 700 x 200 píxeles y el ancho del cuadro delimitador es de 70 píxeles, el ancho devuelto es 0,1.
## Contenido
** Height **
La altura del cuadro delimitador expresada proporcional respecto a la altura total de la página del documento.
Type: Float
Obligatorio: No
** Left **
La coordenada izquierda del cuadro delimitador expresada proporcional respecto a la anchura total de la página del documento.
Type: Float
Obligatorio: No
** Top **
La coordenada superior del cuadro delimitador expresada proporcional respecto a la altura total de la página del documento.
Type: Float
Obligatorio: No
** Width **
La anchura del cuadro delimitador expresada proporcional respecto a la anchura total de la página del documento.
Type: Float
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/BoundingBox)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/BoundingBox)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/BoundingBox)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/BoundingBox)
# Document
El documento de entrada, ya sea en bytes o como objeto S3.
Puede transferir bytes de imágenes a una operación API Amazon Textract Texact utilizando la`Bytes`propiedad. Por ejemplo, debería utilizar el`Bytes`para pasar un documento cargado desde un sistema de archivos local. Bytes de imagen pasados mediante el`Bytes`La propiedad debe tener codificación base64. Es posible que el código no necesite codificar bytes de archivos de documentos si utiliza un SDK de AWS para llamar a las operaciones de la API de Amazon Textract Texact.
Puede transferir imágenes almacenadas en un bucket de S3 a una operación de API Amazon Textract Texact utilizando la`S3Object`propiedad. Los documentos almacenados en un bucket de S3 no tienen por qué estar codificados en base64.
La región de AWS del bucket de S3 que contiene el objeto S3 debe coincidir con la región de AWS que utiliza para las operaciones de Amazon Textract Texact.
Si utiliza la CLI de AWS para llamar a las operaciones de Amazon Textract Texact, no es posible transferir bytes de imágenes utilizando la propiedad Bytes. Debe cargar primero el documento en un bucket de Amazon S3 y, a continuación, llamar a la operación utilizando la propiedad S3Object.
Para que Amazon Textract Texact procese un objeto S3, el usuario debe tener permiso para acceder al objeto S3.
## Contenido
** Bytes **
Blob de bytes de documento codificados en base64. El tamaño máximo de un documento que se proporciona en un blob de bytes es de 5 MB. Los bytes de documento deben estar en formato PNG o JPEG.
Si utiliza un SDK de AWS para llamar a Amazon Textract, es posible que no tenga que codificar en base 64 bytes de imagen pasados mediante el`Bytes`.
Type: Objeto de datos binarios codificados en Base64
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 10485760 caracteres.
Obligatorio: No
** S3Object **
Identifica un objeto S3 como origen del documento. El tamaño máximo de un documento almacenado en un depósito de S3 es de 5 MB.
Tipo: objeto [S3Object](API_S3Object.md)
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Document)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Document)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Document)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Document)
# DocumentLocation
El bucket de Amazon S3 que contiene el documento que se van a procesar. Se utiliza en operaciones asíncronas como[StartDocumentTextDetection](API_StartDocumentTextDetection.md).
El documento de entrada puede ser un archivo de imagen en formato JPEG o PNG. También puede ser un archivo en formato PDF.
## Contenido
** S3Object **
El bucket de Amazon S3 que contiene el documento de entrada.
Tipo: objeto [S3Object](API_S3Object.md)
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/DocumentLocation)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/DocumentLocation)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/DocumentLocation)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/DocumentLocation)
# DocumentMetadata
Información sobre el documento de entrada.
## Contenido
** Pages **
Número de páginas detectadas en el documento.
Type: Entero
Rango válido: Valor mínimo de 0.
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/DocumentMetadata)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/DocumentMetadata)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/DocumentMetadata)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/DocumentMetadata)
# ExpenseDetection
Objeto utilizado para almacenar información sobre el valor o la etiqueta detectados por Amazon Textract.
## Contenido
** Confidence **
La confianza en la detección, en porcentaje
Type: Float
Rango válido: Valor mínimo de 0. Valor máximo de 100.
Obligatorio: No
** Geometry **
Información sobre dónde se encuentran los siguientes elementos en una página de documento: página detectada, texto, pares clave-valor, tablas, celdas de tabla y elementos de selección.
Tipo: objeto [Geometry](API_Geometry.md)
Obligatorio: No
** Text **
La palabra o línea de texto reconocida por Amazon Textract
Type: Cadena
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/ExpenseDetection)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/ExpenseDetection)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/ExpenseDetection)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/ExpenseDetection)
# ExpenseDocument
Estructura que contiene toda la información devuelta por AnalyzeExpense
## Contenido
** ExpenseIndex **
Indica de qué factura o recibo del documento procede la información. El primer documento será 1, el segundo 2, el segundo 2, y así sucesivamente.
Type: Entero
Rango válido: Valor mínimo de 0.
Obligatorio: No
** LineItemGroups **
Información detectada en cada tabla de un documento, separada en`LineItems`.
Type: Matriz de[LineItemGroup](API_LineItemGroup.md)objects
Obligatorio: No
** SummaryFields **
Cualquier información encontrada fuera de una tabla por Amazon Textract.
Type: Matriz de[ExpenseField](API_ExpenseField.md)objects
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/ExpenseDocument)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/ExpenseDocument)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/ExpenseDocument)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/ExpenseDocument)
# ExpenseField
Desglose de la información detectada, separada en las categorías Type, LabelDetection y ValueDetection
## Contenido
** LabelDetection **
Etiqueta indicada explícitamente de un elemento detectado.
Tipo: objeto [ExpenseDetection](API_ExpenseDetection.md)
Obligatorio: No
** PageNumber **
Número de página en el que se ha detectado el valor.
Type: Entero
Rango válido: Valor mínimo de 0.
Obligatorio: No
** Type **
Etiqueta implícita de un elemento detectado. Presente junto con LabelDetection para elementos explícitos.
Tipo: objeto [ExpenseType](API_ExpenseType.md)
Obligatorio: No
** ValueDetection **
Valor de un elemento detectado. Presente en elementos explícitos e implícitos.
Tipo: objeto [ExpenseDetection](API_ExpenseDetection.md)
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/ExpenseField)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/ExpenseField)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/ExpenseField)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/ExpenseField)
# ExpenseType
Objeto utilizado para almacenar información sobre el tipo detectado por Amazon Textract.
## Contenido
** Confidence **
La confianza de la precisión, como porcentaje.
Type: Float
Rango válido: Valor mínimo de 0. Valor máximo de 100.
Obligatorio: No
** Text **
Palabra o línea de texto detectada por Amazon Textract.
Type: Cadena
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/ExpenseType)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/ExpenseType)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/ExpenseType)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/ExpenseType)
# Geometry
Información sobre dónde se encuentran los siguientes elementos en una página de documento: página detectada, texto, pares clave-valor, tablas, celdas de tabla y elementos de selección.
## Contenido
** BoundingBox **
Representación gruesa alineada con el eje de la ubicación del elemento reconocido en la página del documento.
Tipo: objeto [BoundingBox](API_BoundingBox.md)
Obligatorio: No
** Polygon **
Dentro del cuadro delimitador, un polígono de grano fino alrededor del elemento reconocido.
Type: Matrices de[Point](API_Point.md)objects
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Geometry)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Geometry)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Geometry)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Geometry)
# HumanLoopActivationOutput
Muestra los resultados de la evaluación humana en bucle. Si no hay HumanLooParn, la entrada no activó la revisión humana.
## Contenido
** HumanLoopActivationConditionsEvaluationResults **
Muestra el resultado de las evaluaciones de afecciones, incluidas las condiciones que activaron una revisión humana.
Type: Cadena
Restricciones de longitud: La longitud máxima es de 10240 caracteres.
Obligatorio: No
** HumanLoopActivationReasons **
Muestra si se necesitaba una revisión humana y por qué.
Type: Matriz de cadenas
Miembros de la matriz: Número mínimo de 1 elemento.
Obligatorio: No
** HumanLoopArn **
Nombre de recurso de Amazon (ARN) del HumanLoop creado.
Type: Cadena
Restricciones de longitud: La longitud máxima es de 256 caracteres.
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/HumanLoopActivationOutput)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/HumanLoopActivationOutput)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/HumanLoopActivationOutput)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/HumanLoopActivationOutput)
# HumanLoopConfig
Configura el flujo de trabajo de revisión humana al que se enviará el documento si se cumple una de las condiciones. También puedes establecer ciertos atributos de la imagen antes de revisar.
## Contenido
** DataAttributes **
Establece los atributos de los datos de entrada.
Tipo: objeto [HumanLoopDataAttributes](API_HumanLoopDataAttributes.md)
Obligatorio: No
** FlowDefinitionArn **
El nombre de recurso de Amazon (ARN) de la definición del flujo.
Type: Cadena
Restricciones de longitud: La longitud máxima es de 256 caracteres.
Obligatorio: Sí
** HumanLoopName **
El nombre del flujo de trabajo humano utilizado para esta imagen. Esto debe ser único dentro de una región.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 63 caracteres.
Patrón: `^[a-z0-9](-*[a-z0-9])*`
Obligatorio: Sí
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/HumanLoopConfig)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/HumanLoopConfig)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/HumanLoopConfig)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/HumanLoopConfig)
# HumanLoopDataAttributes
Permite definir los atributos de la imagen. En la actualidad, puedes declarar una imagen libre de información de identificación personal y contenido para adultos.
## Contenido
** ContentClassifiers **
Establece si la imagen de entrada está libre de información de identificación personal o contenido para adultos.
Type: Matriz de cadenas
Miembros de matrices: Número máximo de 256 elementos.
Valores válidos:` FreeOfPersonallyIdentifiableInformation | FreeOfAdultContent`
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/HumanLoopDataAttributes)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/HumanLoopDataAttributes)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/HumanLoopDataAttributes)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/HumanLoopDataAttributes)
# IdentityDocument
Estructura que enumera cada documento procesado en una operación AnalyzeID.
## Contenido
** DocumentIndex **
Indica la ubicación de un documento en la lista IdentityDocument. El primer documento está marcado como 1, el segundo 2, etc.
Type: Entero
Rango válido: Valor mínimo de 0.
Obligatorio: No
** IdentityDocumentFields **
Estructura utilizada para registrar la información extraída de los documentos de identidad. Contiene el campo normalizado y el valor del texto extraído.
Type: Matriz de[IdentityDocumentField](API_IdentityDocumentField.md)objects
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/IdentityDocument)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/IdentityDocument)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/IdentityDocument)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/IdentityDocument)
# IdentityDocumentField
Estructura que contiene el tipo normalizado de la información extraída y el texto asociado a ella. Se extraen como Tipo y Valor respectivamente.
## Contenido
** Type **
Se utiliza para contener la información detectada por una operación AnalyzeID.
Tipo: objeto [AnalyzeIDDetections](API_AnalyzeIDDetections.md)
Obligatorio: No
** ValueDetection **
Se utiliza para contener la información detectada por una operación AnalyzeID.
Tipo: objeto [AnalyzeIDDetections](API_AnalyzeIDDetections.md)
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/IdentityDocumentField)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/IdentityDocumentField)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/IdentityDocumentField)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/IdentityDocumentField)
# LineItemFields
Estructura que contiene información sobre las diferentes líneas que se encuentran en las tablas de un documento.
## Contenido
** LineItemExpenseFields **
ExpenseFields utilizados para mostrar información de líneas detectadas en una tabla.
Type: Matrices de[ExpenseField](API_ExpenseField.md)objects
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/LineItemFields)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/LineItemFields)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/LineItemFields)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/LineItemFields)
# LineItemGroup
Agrupación de tablas que contienen elementos de línea, con cada tabla identificada por la tabla`LineItemGroupIndex`.
## Contenido
** LineItemGroupIndex **
Número utilizado para identificar una tabla específica de un documento. La primera tabla encontrada tendrá un LineItemGroupIndex de 1, el segundo 2, etc.
Type: Entero
Rango válido: Valor mínimo de 0.
Obligatorio: No
** LineItems **
Desglose de la información de una línea concreta de una tabla.
Type: Matriz de[LineItemFields](API_LineItemFields.md)objects
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/LineItemGroup)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/LineItemGroup)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/LineItemGroup)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/LineItemGroup)
# NormalizedValue
Contiene información relativa a las fechas de un documento, incluidos el tipo de valor y el valor.
## Contenido
** Value **
El valor de la fecha, escrito como año-mes-día:minuto:segundo.
Type: Cadena
Obligatorio: No
** ValueType **
Tipo normalizado del valor detectado. En este caso, FECHA.
Type: Cadena
Valores válidos:` DATE`
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/NormalizedValue)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/NormalizedValue)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/NormalizedValue)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/NormalizedValue)
# NotificationChannel
El tema de Amazon Simple Notification Service (Amazon SNS) en el que Amazon Textract Texact publica el estado de finalización de una operación de documento asíncrona, como[StartDocumentTextDetection](API_StartDocumentTextDetection.md).
## Contenido
** RoleArn **
Es el nombre de recurso de Amazon (ARN) de un rol de IAM que otorga permisos de publicación a Amazon Texact al tema de Amazon SNS.
Type: Cadena
Restricciones de longitud: Longitud mínima de 20. La longitud máxima es de 2048 caracteres.
Patrón: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`
Obligatorio: Sí
** SNSTopicArn **
Tema de Amazon SNS en el que Amazon Textract publica el estado de finalización.
Type: Cadena
Restricciones de longitud: Longitud mínima de 20. La longitud máxima es de 1024 caracteres.
Patrón: `(^arn:([a-z\d-]+):sns:[a-zA-Z\d-]{1,20}:\w{12}:.+$)`
Obligatorio: Sí
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/NotificationChannel)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/NotificationChannel)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/NotificationChannel)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/NotificationChannel)
# OutputConfig
Establece si la salida irá o no a un bucket creado por el usuario. Se utiliza para establecer el nombre del depósito y el prefijo del archivo de salida.
`OutputConfig`es un parámetro opcional que le permite ajustar dónde se colocará la salida. De forma predeterminada, Amazon Textract almacenará los resultados internamente y solo se puede acceder a ellos mediante las operaciones de Get API. Con OutputConfig habilitado, puedes establecer el nombre del bucket al que se enviará la salida y el prefijo de archivo de los resultados, donde puedes descargar los resultados. Además, puede configurar el`KMSKeyID`a una clave maestra de cliente (CMK) para cifrar la salida. Sin este conjunto de parámetros, Amazon Textract Texact cifrará el lado del servidor mediante la CMK administrada de AWS para Amazon S3.
El descifrado del contenido del cliente es necesario para procesar los documentos por parte de Amazon Textract. Si su cuenta se excluye según una política de exclusión de servicios de IA, todo el Contenido del cliente no cifrado se elimina de forma inmediata y permanente después de que el servicio haya procesado el Contenido del cliente. Amazon Texact no conserva ninguna copia de la salida. Para obtener información acerca de cómo excluirlas, consulte[Administración de políticas de exclusión de servicios de IA.](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_ai-opt-out.html)
Para obtener más información acerca de la privacidad de datos, consulte[Preguntas frecuentes sobre privacidad de datos](https://aws.amazon.com/compliance/data-privacy-faq/).
## Contenido
** S3Bucket **
El nombre del depósito al que irá a la salida.
Type: Cadena
Restricciones de longitud: Longitud mínima de 3. La longitud máxima es de 255 caracteres.
Patrón: `[0-9A-Za-z\.\-_]*`
Obligatorio: Sí
** S3Prefix **
El prefijo de la clave de objeto en el que se va a guardar la salida. Si no está habilitado, el prefijo será «textract\$1output».
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 1024 caracteres.
Patrón: `.*\S.*`
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/OutputConfig)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/OutputConfig)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/OutputConfig)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/OutputConfig)
# Point
Las coordenadas X e Y de un punto de una página de documento. Los valores X e Y que se devuelven son proporciones del tamaño total de página del documento. Por ejemplo, si el documento de entrada es 700 x 200 y la operación devuelve X=0,5 e Y=0,25, el punto se encuentra en la coordenada de píxeles (350,50) de la página del documento.
Una matriz de`Point`objects,`Polygon`se devuelve como parte de la[Geometry](API_Geometry.md)objeto que se devuelve en un[Block](API_Block.md)object. UNA`Polygon`representa un polígono de grano fino alrededor del texto detectado, un par clave-valor, una tabla, una celda de tabla o un elemento de selección.
## Contenido
** X **
El valor de la coordenada X de un punto de un`Polygon`.
Type: Float
Obligatorio: No
** Y **
El valor de la coordenada Y de un punto de un`Polygon`.
Type: Float
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Point)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Point)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Point)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Point)
# Relationship
Información sobre cómo se relacionan los bloques entre sí. UNA`Block`objeto contiene 0 o más`Relation`objetos de una lista,`Relationships`. Para obtener más información, consulte [Block](API_Block.md).
La`Type`proporciona el tipo de relación de todos los bloques del`IDs`matriz.
## Contenido
** Ids **
Matriz de ID para bloques relacionados. Puede obtener el tipo de relación del`Type`elemento.
Type: Matriz de cadenas
Patrón: `.*\S.*`
Obligatorio: No
** Type **
Tipo de relación que tienen los bloques de la matriz IDs con el bloque actual. La relación puede ser`VALUE`o`CHILD`. Una relación de tipo VALUE es una lista que contiene el ID del bloque VALUE asociado a la CLAVE de un par clave-valor. Una relación de tipo CHILD es una lista de ID que identifican bloques WORD en el caso de líneas Bloques de celdas en el caso de Tablas y bloques WORD en el caso de Elementos de selección.
Type: Cadena
Valores válidos:` VALUE | CHILD | COMPLEX_FEATURES`
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Relationship)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Relationship)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Relationship)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Relationship)
# S3Object
El nombre del bucket de S3 y el nombre de archivo que identifican el documento.
La región de AWS para el bucket de S3 que contiene el documento debe coincidir con la región que utiliza para las operaciones de Amazon Textract Texact.
Para que Amazon Textract Texact procese un archivo en un bucket de S3, el usuario debe tener permiso para acceder al bucket y al archivo de S3.
## Contenido
** Bucket **
Nombre del bucket de S3. Tenga en cuenta que el carácter \$1 no es válido en el nombre del archivo.
Type: Cadena
Restricciones de longitud: Longitud mínima de 3. La longitud máxima es de 255 caracteres.
Patrón: `[0-9A-Za-z\.\-_]*`
Obligatorio: No
** Name **
El nombre de archivo del documento de entrada. Las operaciones sincrónicas pueden utilizar archivos de imagen en formato JPEG o PNG. Las operaciones asíncronas también admiten archivos en formato PDF y TIFF.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 1024 caracteres.
Patrón: `.*\S.*`
Obligatorio: No
** Version **
Si en el bucket se ha habilitado el control de versiones, puede especificar la versión del objeto.
Type: Cadena
Restricciones de longitud: Longitud mínima de 1. La longitud máxima es de 1024 caracteres.
Patrón: `.*\S.*`
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/S3Object)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/S3Object)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/S3Object)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/S3Object)
# Warning
Una advertencia sobre un problema que se produjo durante el análisis de texto asíncrono ([StartDocumentAnalysis](API_StartDocumentAnalysis.md)) o detección de texto de documentos asíncrona ([StartDocumentTextDetection](API_StartDocumentTextDetection.md)).
## Contenido
** ErrorCode **
El código de error de la advertencia.
Type: Cadena
Obligatorio: No
** Pages **
Lista de las páginas a las que se aplica la advertencia.
Type: Matriz de números enteros
Rango válido: Valor mínimo de 0.
Obligatorio: No
## Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/Warning)
+ [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/Warning)
+ [AWSSDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/Warning)
+ [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/Warning)