Method: mediaItems.batchGet

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של 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)

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