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)

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