הוצאנו משימוש את v1beta2 API של Document AI, ועכשיו אנחנו ממליצים להשתמש ב-API v1.
בניגוד ל-v1beta2, Document AI v1 הוא API עם שמירת מצב. כלומר, צריך ליצור Processor לפני ששולחים בקשות למסמכי Process ו-BatchProcess.
הערה: הוצאת הגרסה הזו משימוש משפיעה רק על הגרסה של ה-API שמשמשת לקריאה למעבד כלשהו. ההגדרה הזו לא משפיעה על הזמינות של מעבד כלשהו.
בהמשך המסמך מפורטים התחומים העיקריים שבהם יש חוסר תאימות לאחור בין API גרסה 1 לבין API גרסה 1beta2.
יצירת מעבד
כדי לעבור אל v1 כדי ליצור מעבד, קודם צריך ליצור Processor. הטבלה הבאה היא הנחיה כללית לבחירת ProcessorType מתאים ליצירה, אבל אפשר לעיין ברשימת המעבדים המלאה.
document_type |
params |
סוג המעבד |
|---|---|---|
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 |
למדריך מפורט ליצירת מעבד, ראו את המדריך.
עיבוד מסמכים
ל-Document AI v1 יש שני ממשקי API לקבלת מסמכים: Process ו-BatchProcess.
כל אחת מהשיטות האלה תואמת לשיטה מ-v1beta2. השיטות וההבדלים ביניהן מודגשים:
v1beta2 Method |
v1 Method |
הערות לגבי ההעברה |
|---|---|---|
ProcessDocument |
Process |
InputConfig.Cloud Storage_source לא נתמך ב-v1, צריך להשתמש ב-BatchProcess כדי לעבד מסמכים ב-Cloud Storage. |
BatchProcessDocuments |
BatchProcess |
בנוסף לקבלת מסמכים בודדים ב-Cloud Storage, v1 תומך בקידומת של Cloud Storage לעיבוד של מסמכים רבים בבת אחת. |
ספריות לקוח
אם אתם משתמשים ב-Client Libraries כדי לקיים אינטראקציה עם Document AI, אתם צריכים לעבור משימוש ב-DocumentUnderstandingService לשימוש ב-DocumentProcessorService. דוגמה מפורטת לשימוש בספריות הלקוח של v1 זמינה במאמר ספריות לקוח.