Method: mediaItems.list

הצגת רשימה של כל פריטי המדיה מספריית Google Photos של המשתמש.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
pageSize

integer

המספר המקסימלי של פריטי מדיה שיוחזרו בתגובה. ייתכן שיוחזרו פחות פריטי מדיה מהמספר שצוין. ערך ברירת המחדל של pageSize הוא 25 והערך המקסימלי הוא 100.
pageToken

string

אסימון המשך לקבלת הדף הבא של התוצאות. הוספה של ערך זה לבקשה תחזיר את השורות אחרי pageToken. pageToken צריך להיות הערך שהוחזר בפרמטר nextPageToken בתגובה לבקשה של listMediaItems.

גוף הבקשה

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

גוף התשובה

רשימה של כל פריטי המדיה מספריית Google Photos של המשתמש.

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

ייצוג JSON 
{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "nextPageToken": string
}
שדות
mediaItems[]

object (MediaItem)

פלט בלבד. רשימה של פריטי מדיה בספריית המשתמש.
nextPageToken

string

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

היקפי הרשאות

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

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