כששולחים קובצי מסמכים אל Document AI API, אפשר לשלוח נתונים ישירות בשדה RawDocument.content עם עיבוד אונליין בלבד אם הקובץ בגודל 20 MB או פחות.
קובץ הקלט יהיה בפורמט בינארי, ולכן צריך לקודד אותו לפני השליחה אל Document AI.
אם קובץ הקלט חורג ממגבלות העיבוד אונליין, צריך לאחסן אותו בקטגוריה של Cloud Storage כדי לשלוח אותו לעיבוד, שלא דורש קידוד. פרטים נוספים מופיעים במסמכי התיעוד בנושא עיבוד באצווה.
שימוש בשורת הפקודה
בבקשת gRPC, אפשר פשוט לכתוב נתונים בינאריים ישירות. עם זאת, כשמבצעים בקשת REST, משתמשים ב-JSON. JSON הוא פורמט טקסט שלא תומך ישירות בנתונים בינאריים, ולכן צריך להמיר נתונים בינאריים כאלה לטקסט באמצעות קידוד Base64.
רוב סביבות הפיתוח מכילות כלי עזר מקורי של base64 לקידוד קובץ בינארי לנתוני טקסט ב-ASCII. כדי לקודד קובץ:
Linux
מקודדים את הקובץ באמצעות הכלי base64 בשורת הפקודה, ומוודאים שמונעים גלישת שורות באמצעות הדגל -w 0:
base64 INPUT_FILE -w 0 > OUTPUT_FILE
macOS
מקודדים את הקובץ באמצעות הכלי base64 של שורת הפקודה:
base64 -i INPUT_FILE -o OUTPUT_FILE
Windows
מקודדים את הקובץ באמצעות הכלי Base64.exe:
Base64.exe -e INPUT_FILE > OUTPUT_FILE
PowerShell
מבצעים קידוד של הקובץ באמצעות ה-method Convert.ToBase64String:
[Convert]::ToBase64String([IO.File]::ReadAllBytes("./INPUT_FILE")) > OUTPUT_FILE
יוצרים קובץ בקשת JSON, ומוסיפים את הנתונים בקידוד base64:
JSON