Method: mediaItems.list

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

תוחזר שגיאת FAILED_PRECONDITION אם בסשן עדיין אין פריטי מדיה שנבחרו ולכן לא ניתן להחזיר תוכן מדיה. בתרחיש הזה, אפליקציות שפועלות במכשירים עם קלט מוגבל צריכות לעבד קוד QR שמקודד את ה-pickerUri של הסשן, ותבקש מהמשתמש לסרוק את הקוד ולבחור פריטי מדיה בממשק המשתמש של הבורר של Google Photos. בזמן שהמשתמש ממתין לבחירת הפריטים שלו, הלקוחות צריכים לבצע סקר sessions.get פעם בpollingConfig.pollInterval, עד pickedItemsSet = true בתשובה של sessions.get. בשלב הזה, הלקוחות עשויים להמשיך להתקשר אל mediaItems.list ולצפות לקבל תשובה מוצלחת.

בקשת HTTP

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

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

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

פרמטרים
sessionId

string

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

integer

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

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

string

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

גוף הבקשה

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

גוף התשובה

תשובה ל-RPC 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