Method: projects.files.annotate

שירות שמבצע זיהוי תמונות והוספת הערות לקבוצת קבצים. עכשיו יש תמיכה רק בערכים application/pdf,‏ image/tiff ו-image/gif.

השירות הזה יחלץ לכל היותר 5 פריימים (gif) או דפים (pdf או tiff) מכל קובץ שיישלח, ויבצע זיהוי והוספת הערות לכל תמונה שחולצה. (הלקוחות יכולים לציין אילו 5 פריימים או דפים לחלץ באמצעות AnnotateFileRequest.pages).

בקשת HTTP

POST https://vision.googleapis.com/v1/{parent=projects/*}/files:annotate

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

פרמטרים של נתיב

פרמטרים
parent

string

זה שינוי אופציונלי. מטרגטים פרויקט ומיקום כדי לבצע קריאה.

פורמט: projects/{project-id}/locations/{location-id}

אם לא מציינים הורה, המערכת תבחר אזור באופן אוטומטי.

מזהי מיקום נתמכים: us: ארה"ב בלבד, asia: אזורים במזרח אסיה, כמו יפן וטייוואן, eu: האיחוד האירופי.

דוגמה: projects/project-A/locations/eu

גוף הבקשה

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

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

object (AnnotateFileRequest)

חובה. רשימת הבקשות להערות בקובץ. בשלב הזה אנחנו תומכים רק ב-AnnotateFileRequest אחד ב-BatchAnnotateFilesRequest.

גוף התשובה

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

היקפי הרשאות

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

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

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