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

MediaItemResult

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

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

object (Status)

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

object (MediaItem)

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