Method: mediaItems.list

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

אם המשתמש עדיין לא סיים לבחור פריטי מדיה לסשן שצוין, תוחזר שגיאה מסוג FAILED_PRECONDITION. בתרחיש כזה, האפליקציה צריכה לבצע סקרים של sessions.get עד שהסשן יהיה מוכן, ואז לנסות שוב את השיטה הזו.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
sessionId

string

חובה. המזהה שנוצר על ידי Google עבור הסשן הזה.
pageSize

integer

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

יכול להיות שהשירות יחזיר פחות מהערך הזה (כולל אפס תוצאות). אם לא מציינים ערך או מגדירים ערך של 0, יוחזרו עד 50 פריטי מדיה. הערך המקסימלי הוא 100. ערכים מעל 100 יומרו לערך 100. ערכים שליליים יגרמו לשגיאה מסוג INVALID_ARGUMENT.
pageToken

string

זה שינוי אופציונלי. אסימון דף, שהתקבל משיחה קודמת של mediaItems.list. צריך לספק אותו כדי לאחזר את הדף הבא.

גוף הבקשה

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

גוף התשובה

התגובה לשיטה mediaItems.list.

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

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

object (PickedMediaItem)

דף של פריטי מדיה שנבחרו.
nextPageToken

string

אם השדה הזה מוגדר, אפשר להשתמש בו כ-pageToken בקריאה הבאה של mediaItems.list כדי לאחזר את הדף הבא של פריטי המדיה שנבחרו.

אם השדה הזה לא יצוין, לא יהיו דפים נוספים.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly