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. # 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)