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
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata

MediaItemResult

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

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

object (Status)

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

object (MediaItem)

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