Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# AnalyzeExpense
`AnalyzeExpense`analyse de manière synchrone un document d'entrée pour détecter les relations financières entre le texte.
Les informations sont renvoyées sous la forme`ExpenseDocuments`et se sont séparés comme suit.
+ `LineItemGroups`- Un ensemble de données contenant`LineItems`qui stockent des informations sur les lignes de texte, telles qu'un article acheté et son prix sur un reçu.
+ `SummaryFields`- Contient toutes les autres informations d'un reçu, telles que les informations d'en-tête ou le nom du fournisseur.
## Syntaxe de la demande
```
{
"Document": {
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
}
```
## Paramètres de demande
Cette demande accepte les données suivantes au format JSON.
** [Document](#API_AnalyzeExpense_RequestSyntax) **
Le document d'entrée, soit en octets, soit en tant qu'objet S3.
Pour transmettre des octets d'image à une opération d'API Amazon Textract, utilisez la commande`Bytes`propriété. Par exemple, utilisez la commande`Bytes`pour transmettre un document chargé à partir d'un système de fichiers local. Octets d'image transmis à l'aide de l'option`Bytes`doit être codée en base64. Il est possible que votre code n'ait pas besoin de coder des octets de fichiers de documents si vous utilisez un kit SDK AWS pour appeler les opérations de l'API Amazon Textract.
Pour transmettre des images stockées dans un compartiment S3 à une opération d'API Amazon Textract, utilisez la commande`S3Object`propriété. Il n'est pas nécessaire d'encoder en base64 les documents stockés dans un compartiment S3.
La région AWS du compartiment S3 contenant l'objet S3 doit correspondre à la région AWS que vous utilisez pour les opérations Amazon Textract.
Si vous utilisez l'AWS CLI pour appeler des opérations Amazon Textract, la transmission d'octets d'image à l'aide de la propriété Bytes n'est pas prise en charge. Vous devez d'abord charger le document dans un compartiment Amazon S3, puis appeler l'opération à l'aide de la propriété S3Object.
Pour qu'Amazon Textract traite un objet S3, l'utilisateur doit disposer des autorisations permettant d'accéder à l'objet S3.
Type : objet [Document](API_Document.md)
Regatoire : Oui
## Syntaxe de la réponse
```
{
"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"
}
}
]
}
]
}
```
## Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
** [DocumentMetadata](#API_AnalyzeExpense_ResponseSyntax) **
Informations sur le document d'entrée.
Type : objet [DocumentMetadata](API_DocumentMetadata.md)
** [ExpenseDocuments](#API_AnalyzeExpense_ResponseSyntax) **
Les dépenses détectées par Amazon Textract.
Type : Tableau de[ExpenseDocument](API_ExpenseDocument.md)objets
## Erreurs
** AccessDeniedException **
Vous n'êtes pas autorisé à effectuer l'action. Utilisez l'Amazon Resource Name (ARN) d'un utilisateur ou d'un rôle IAM autorisé pour effectuer l'opération.
Code d'état HTTP : 400
** BadDocumentException **
Amazon Textract n'est pas en mesure de lire le document. Pour plus d'informations sur les limites de documents dans Amazon Textract, voir[Limites strictes dans Amazon Textract](limits.md).
Code d'état HTTP : 400
** DocumentTooLargeException **
Le document ne peut pas être traité car il est trop volumineux. Taille maximale du document pour les opérations synchrone 10 Mo. La taille maximale du document pour les opérations asynchrones est de 500 Mo pour les fichiers PDF.
Code d'état HTTP : 400
** InternalServerError **
Amazon Textract a rencontré un problème de service. Renouvelez votre appel.
Code d'état HTTP : 500
** InvalidParameterException **
Un paramètre d'entrée a enfreint une contrainte. Par exemple, dans les opérations synchrone, un`InvalidParameterException`exception se produit lorsque aucune des options`S3Object`ou`Bytes`les valeurs sont fournies dans le`Document`paramètre de demande. Validez votre paramètre avant d'appeler à nouveau l'opération d'API.
Code d'état HTTP : 400
** InvalidS3ObjectException **
Amazon Textract n'est pas en mesure d'accéder à l'objet S3 spécifié dans la demande. Pour plus d'informations, consultez la page[Configuration de l'accès à Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Pour plus d'informations sur le dépannage, consultez[Résolutions des problèmes liés à Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Code d'état HTTP : 400
** ProvisionedThroughputExceededException **
Le nombre de demandes dépasse votre limite de débit. Si vous avez besoin d'augmenter cette limite, contactez Amazon Textract.
Code d'état HTTP : 400
** ThrottlingException **
Amazon Textract est temporairement dans l'impossibilité de traiter la demande. Renouvelez votre appel.
Code d'état HTTP : 500
** UnsupportedDocumentException **
Le format du document d'entrée n'est pas prise en charge. Les documents utilisés pour les opérations peuvent être au format PNG, JPEG, PDF ou TIFF.
Code d'état HTTP : 400
## Voir aussi
Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :
+ [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeExpense)
+ [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeExpense)
+ [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeExpense)
+ [AWSSDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeExpense)
+ [Kit AWS SDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeExpense)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeExpense)
+ [AWSSDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeExpense)