L'API v1beta2 de Document AI est désormais obsolète au profit de l'API v1.
Contrairement à v1beta2, l'API Document AI v1 est une API avec état. Cela signifie que vous devez créer un Processor avant de pouvoir envoyer des requêtes aux documents Process et BatchProcess.
REMARQUE : Cette obsolescence n'affecte que la version de l'API utilisée pour appeler un processeur. Cela n'a aucune incidence sur la disponibilité des processeurs.
Les principaux domaines d'incompatibilité de l'API v1 avec l'API v1beta2 sont abordés plus loin dans ce document.
Créer un processeur
Pour migrer vers v1 pour la création de processeurs, commencez par créer un Processor. Le tableau suivant sert de guide général pour choisir un ProcessorType à créer, mais vous pouvez consulter la liste complète des processeurs.
document_type |
params |
Type de processeur |
|---|---|---|
invoice |
INVOICE_PROCESSOR |
|
general |
OCR_PROCESSOR |
|
general |
table_extraction_params |
FORM_PARSER_PROCESSOR |
general |
form_extraction_params |
FORM_PARSER_PROCESSOR |
general |
entity_extraction_params |
FORM_PARSER_PROCESSOR |
general |
automl_params |
CUSTOM_EXTRACTION_PROCESSOR |
Pour obtenir un guide par étapes sur la création d'un processeur, consultez le guide.
Traitement des documents
Document AI v1 dispose de deux API pour accepter les documents : Process et BatchProcess.
Chacune de ces méthodes correspond à une méthode de v1beta2. Les méthodes et leurs différences sont mises en évidence :
Méthode v1beta2 |
Méthode v1 |
Remarques sur la migration |
|---|---|---|
ProcessDocument |
Process |
InputConfig.Cloud Storage_source n'est pas compatible avec v1. Utilisez BatchProcess pour traiter les documents sur Cloud Storage. |
BatchProcessDocuments |
BatchProcess |
En plus d'accepter les documents individuels sur Cloud Storage, v1 est compatible avec un préfixe Cloud Storage pour traiter plusieurs documents à la fois. |
Bibliothèques clientes
Si vous utilisez Client Libraries pour interagir avec Document AI, passez de DocumentUnderstandingService à DocumentProcessorService. Pour obtenir un exemple détaillé d'utilisation des bibliothèques clientes pour v1, consultez Bibliothèques clientes.