- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
तय सेशन के दौरान उपयोगकर्ता के चुने गए मीडिया आइटम की सूची दिखाता है.
अगर सेशन में अब तक कोई भी चुना गया मीडिया आइटम नहीं है, तो FAILED_PRECONDITION
गड़बड़ी मिलेगी. इसलिए, वह मीडिया कॉन्टेंट नहीं दिखा सकता. ऐसे मामले में, सीमित इनपुट वाले डिवाइसों पर चल रहे ऐप्लिकेशन को सेशन के pickerUri
को कोड में बदलने वाला क्यूआर कोड रेंडर करना होगा. इससे उपयोगकर्ता को कोड स्कैन करने और Google Photos पिकर के यूज़र इंटरफ़ेस (यूआई) में मीडिया आइटम चुनने के लिए कहा जाएगा. उपयोगकर्ता के आइटम चुनने का इंतज़ार करते समय, क्लाइंट को हर pollingConfig.pollInterval
में एक बार sessions.get
के लिए पोल करना चाहिए. ऐसा sessions.get
के जवाब में pickedItemsSet = true
तक करना चाहिए. ऐसा होने के बाद, क्लाइंट फिर से mediaItems.list
को कॉल करना शुरू कर सकते हैं और उम्मीद करते हैं कि उन्हें सही जवाब मिलेगा.
एचटीटीपी अनुरोध
GET https://photospicker.googleapis.com/v1/mediaItems
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
sessionId |
ज़रूरी है. इस सेशन के लिए Google का जनरेट किया गया आइडेंटिफ़ायर. |
pageSize |
ज़रूरी नहीं. लौटाए जाने वाले मीडिया आइटम की ज़्यादा से ज़्यादा संख्या. सेवा इस वैल्यू से कम वैल्यू दिखा सकती है (इसमें शून्य नतीजे भी शामिल हैं). अगर जानकारी नहीं दी जाती या 0 पर सेट की जाती है, तो ज़्यादा से ज़्यादा 50 मीडिया आइटम लौटाए जाएंगे. ज़्यादा से ज़्यादा वैल्यू 100 है; अगर वैल्यू 100 से ज़्यादा है, तो उसे 100 बना दिया जाएगा. नेगेटिव वैल्यू की वजह से |
pageToken |
ज़रूरी नहीं. पिछले |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
mediaItems.list
RPC का जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"mediaItems": [
{
object ( |
फ़ील्ड | |
---|---|
mediaItems[] |
चुने गए मीडिया आइटम का पेज. |
nextPageToken |
टोकन, जिसे |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/photospicker.mediaitems.readonly