Method: files.annotate

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

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

בקשת HTTP

POST https://alpha-vision.googleapis.com/v1/files:annotate

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

גוף הבקשה

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

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

object(AnnotateFileRequest)

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

גוף התשובה

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

רשימה של תגובות לאנוטציות של קבצים.

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

object(AnnotateFileResponse)

רשימת התגובות של הערות הקבצים, כאשר כל תגובה מתאימה לכל AnnotateFileRequest ב-BatchAnnotateFilesRequest.

היקפי הרשאות

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

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

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

AnnotateFileRequest

בקשה להוספת הערות לקובץ אחד, למשל קובץ PDF, ‏ TIFF או GIF.

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

object(InputConfig)

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

features[]

object(Feature)

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

imageContext

object(ImageContext)

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

pages[]

number

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

הדפים מתחילים מ-1, אנחנו מניחים שהדף הראשון בקובץ הוא דף 1. כל בקשה יכולה לכלול עד 5 דפים. הערך של Pages יכול להיות שלילי.

‫Page 1 (עמוד 1) מייצג את העמוד הראשון. ‫Page 2 פירושו הדף השני. הדף -1 הוא הדף האחרון. הדף -2 הוא הדף השני לפני האחרון.

אם הקובץ הוא GIF במקום PDF או TIFF, המונח 'דף' מתייחס למסגרות GIF.

אם השדה הזה ריק, כברירת מחדל השירות מבצע הערות לתמונות ב-5 הדפים הראשונים של הקובץ.

AnnotateFileResponse

תשובה לבקשה להוספת הערה לקובץ יחיד. קובץ יכול להכיל תמונה אחת או יותר, ולכל תמונה יש תשובות משלה.

ייצוג ב-JSON 
{
  "inputConfig": {
    object(InputConfig)
  },
  "responses": [
    {
      object(AnnotateImageResponse)
    }
  ]
}
שדות
inputConfig

object(InputConfig)

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

responses[]

object(AnnotateImageResponse)

תשובות ספציפיות לתמונות שנמצאות בקובץ.

רוצה לנסות?