Method: files.asyncBatchAnnotate

הפעלת זיהוי תמונות והוספת הערות אסינכרוניים לרשימה של קבצים כלליים, כמו קובצי PDF, שעשויים להכיל כמה דפים וכמה תמונות בכל דף. אפשר לאחזר את ההתקדמות והתוצאות דרך הממשק של google.longrunning.Operations. ‫Operation.metadata contains OperationMetadata (מטא-נתונים). Operation.response עם AsyncBatchAnnotateFilesResponse (תוצאות).

בקשת HTTP

POST https://vision.googleapis.com/v1p3beta1/files:asyncBatchAnnotate

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "requests": [
    {
      object(AsyncAnnotateFileRequest)
    }
  ]
}
שדות
requests[]

object(AsyncAnnotateFileRequest)

בקשות נפרדות לסימון קבצים אסינכרוניות עבור הקבוצה הזו.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

מידע נוסף מופיע במאמר סקירה כללית על אימות.

AsyncAnnotateFileRequest

בקשה להערה בקובץ אופליין.

ייצוג ב-JSON 
{
  "inputConfig": {
    object(InputConfig)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  },
  "outputConfig": {
    object(OutputConfig)
  }
}
שדות
inputConfig

object(InputConfig)

חובה. מידע על קובץ הקלט.

features[]

object(Feature)

חובה. תכונות מבוקשות.

imageContext

object(ImageContext)

הקשר נוסף שעשוי להופיע לצד התמונות בקובץ.

outputConfig

object(OutputConfig)

חובה. מיקום הפלט הרצוי ומטא-נתונים (למשל, פורמט).

InputConfig

מיקום הקלט הרצוי והמטא-נתונים.

ייצוג ב-JSON 
{
  "gcsSource": {
    object(GcsSource)
  },
  "mimeType": string
}
שדות
gcsSource

object(GcsSource)

המיקום ב-Google Cloud Storage שממנו יתבצע קריאת הקלט.

mimeType

string

סוג הקובץ. בשלב הזה יש תמיכה רק בערכים application/pdf ו-image/tiff. אין תמיכה בתווים כלליים לחיפוש.

GcsSource

המיקום ב-Google Cloud Storage שממנו יתבצע קריאת הקלט.

ייצוג ב-JSON 
{
  "uri": string
}
שדות
uri

string

‫URI של Cloud Storage של קובץ הקלט. הערך הזה חייב להיות אובייקט ב-Google Cloud Storage. אין כרגע תמיכה בתווים כלליים לחיפוש.

OutputConfig

מיקום הפלט הרצוי והמטא-נתונים.

ייצוג ב-JSON 
{
  "gcsDestination": {
    object(GcsDestination)
  },
  "batchSize": number
}
שדות
gcsDestination

object(GcsDestination)

המיקום ב-Google Cloud Storage שבו ייכתבו הפלט או הפלטים.

batchSize

number

המספר המקסימלי של פרוטוקולי תגובה שיוכנסו לכל קובץ JSON של פלט ב-Google Cloud Storage. הטווח התקין הוא [1, 100]. אם לא מציינים ערך, ערך ברירת המחדל הוא 20.

לדוגמה, עבור קובץ PDF אחד עם 100 דפים, ייווצרו 100 פרוטוקולים של תגובות. אם batchSize = 20, ייכתבו 5 קובצי JSON, כל אחד מהם מכיל 20 פרוטוקולי תגובה, עם הקידומת gcsDestination.uri.

בשלב הזה, batchSize רלוונטי רק ל-GcsDestination, ויכול להיות שבעתיד הוא יהיה רלוונטי גם להגדרות פלט אחרות.

GcsDestination

המיקום ב-Google Cloud Storage שבו הפלט ייכתב.

ייצוג ב-JSON 
{
  "uri": string
}
שדות
uri

string

‫URI של Cloud Storage שבו התוצאות יאוחסנו. התוצאות יהיו בפורמט JSON ולפניהן מזהה ה-URI של הקלט התואם. השדה הזה יכול לייצג קובץ יחיד או קידומת לכמה פלטים. התחיליות צריכות להסתיים ב-/.

דוגמאות:

אם יש כמה פלטים, כל תגובה היא עדיין AnnotateFileResponse, וכל אחת מהן מכילה קבוצת משנה של הרשימה המלאה של AnnotateImageResponse. יכול להיות שיהיו כמה פלטים, למשל אם קובץ ה-JSON של הפלט גדול מדי והוא מתפצל לכמה קבצים.