Method: mediaItems.batchGet

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

בקשת HTTP

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet

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

פרמטרים של שאילתה

פרמטרים
mediaItemIds[]

string

חובה. המזהים של פריטי המדיה שרוצים לבקש. אסור לכלול מזהי חזרה, והוא לא יכול להיות ריק. המספר המקסימלי של פריטי מדיה שאפשר לאחזר בקריאה אחת הוא 50.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

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

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

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

object (MediaItemResult)

פלט בלבד. רשימת קובצי המדיה שאוחזרו. חשוב לזכור שגם אם הקריאה ל-mediaItems.batchGet תצליח, יכול להיות שיהיו כשלים בחלק מפריטי המדיה בקבוצה. הכישלונות האלה מצוינים בכל MediaItemResult.status.

היקפי הרשאה

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

  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata

MediaItemResult

התוצאה של אחזור פריט מדיה.

ייצוג ב-JSON 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
שדות
status

object (Status)

אם אירעה שגיאה במהלך הגישה לפריט המדיה הזה, השדה הזה מאוכלס במידע שקשור לשגיאה. פרטים נוספים על השדה הזה זמינים במאמר Status.
mediaItem

object (MediaItem)

פריט מדיה שאוחזר מהספרייה של המשתמש. השדה מאוכלס אם לא אירעו שגיאות ופריט המדיה אוחזר בהצלחה.