Migrer depuis la version v1beta2
L'API v1beta2 de Document AI est désormais abandonnée au profit de l'API v1.
Contrairement à v1beta2, Document AI v1 est une API avec état, ce qui signifie que vous devez créer un Processor avant de pouvoir envoyer des requêtes aux documents Process et BatchProcess.
REMARQUE: Cette suppression n'affecte que la version de l'API utilisée pour appeler un processeur. Cela n'a aucune incidence sur la disponibilité d'un processeur.
Les principaux domaines d'incompatibilité rétroactive 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 d'un outil de traitement, commencez par créer un Processor. Le tableau suivant sert de guide général pour choisir un ProcessorType approprié à 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 détaillé 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 |
Notes de migration |
|---|---|---|
ProcessDocument |
Process |
InputConfig.Cloud Storage_source n'est pas compatible avec v1. Utilisez BatchProcess pour traiter les documents dans Cloud Storage. |
BatchProcessDocuments |
BatchProcess |
En plus d'accepter des documents individuels dans Cloud Storage, v1 accepte 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é de l'utilisation des bibliothèques clientes pour v1, consultez les bibliothèques clientes.