Method: mediaItems.list

तय सेशन के दौरान उपयोगकर्ता के चुने गए मीडिया आइटम की सूची दिखाता है.

अगर सेशन में अब तक कोई भी चुना गया मीडिया आइटम नहीं है, तो FAILED_PRECONDITION गड़बड़ी मिलेगी. इसलिए, वह मीडिया कॉन्टेंट नहीं दिखा सकता. ऐसे मामले में, सीमित इनपुट वाले डिवाइसों पर चल रहे ऐप्लिकेशन को सेशन के pickerUri को कोड में बदलने वाला क्यूआर कोड रेंडर करना होगा. इससे उपयोगकर्ता को कोड स्कैन करने और Google Photos पिकर के यूज़र इंटरफ़ेस (यूआई) में मीडिया आइटम चुनने के लिए कहा जाएगा. उपयोगकर्ता के आइटम चुनने का इंतज़ार करते समय, क्लाइंट को हर pollingConfig.pollInterval में एक बार sessions.get के लिए पोल करना चाहिए. ऐसा sessions.get के जवाब में pickedItemsSet = true तक करना चाहिए. ऐसा होने के बाद, क्लाइंट फिर से mediaItems.list को कॉल करना शुरू कर सकते हैं और उम्मीद करते हैं कि उन्हें सही जवाब मिलेगा.

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

क्वेरी पैरामीटर

पैरामीटर
sessionId

string

ज़रूरी है. इस सेशन के लिए Google का जनरेट किया गया आइडेंटिफ़ायर.

pageSize

integer

ज़रूरी नहीं. लौटाए जाने वाले मीडिया आइटम की ज़्यादा से ज़्यादा संख्या.

सेवा इस वैल्यू से कम वैल्यू दिखा सकती है (इसमें शून्य नतीजे भी शामिल हैं). अगर जानकारी नहीं दी जाती या 0 पर सेट की जाती है, तो ज़्यादा से ज़्यादा 50 मीडिया आइटम लौटाए जाएंगे. ज़्यादा से ज़्यादा वैल्यू 100 है; अगर वैल्यू 100 से ज़्यादा है, तो उसे 100 बना दिया जाएगा. नेगेटिव वैल्यू की वजह से INVALID_ARGUMENT गड़बड़ी होगी.

pageToken

string

ज़रूरी नहीं. पिछले mediaItems.list कॉल से मिला पेज टोकन. अगले पेज को वापस पाने के लिए, यह जानकारी दें.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

mediaItems.list RPC का जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना
{
  "mediaItems": [
    {
      object (PickedMediaItem)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
mediaItems[]

object (PickedMediaItem)

चुने गए मीडिया आइटम का पेज.

nextPageToken

string

टोकन, जिसे pageToken के तौर पर भेजा जा सकता है, ताकि mediaItems.list के अनुरोध में अगले पेज को वापस लाया जा सके.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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