REST Resource: sessions

रिसॉर्स: PickingSession

उपयोगकर्ता सेशन की इमेज, जिसमें उपयोगकर्ता Google Photos का इस्तेमाल करके फ़ोटो और वीडियो चुन सकता है.

JSON के काेड में दिखाना 
{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "expireTime": string,
  "pickingConfig": {
    object (PickingConfig)
  },
  "mediaItemsSet": boolean
}
फ़ील्ड
id

string

सिर्फ़ आउटपुट के लिए. इस सेशन के लिए Google से जनरेट हुआ आइडेंटिफ़ायर.
pickerUri

string

सिर्फ़ आउटपुट के लिए. उपयोगकर्ता को Google Photos (वेब पर) पर रीडायरेक्ट करने के लिए इस्तेमाल किया जाने वाला यूआरआई, ताकि वे मौजूदा सेशन के लिए फ़ोटो और वीडियो चुन सकें.

इस पेज को देखने के लिए, उपयोगकर्ता को अपने वेब ब्राउज़र में उस Google खाते में लॉग इन करना होगा जिसका मालिकाना हक इस सेशन पर है.

सुरक्षा से जुड़ी वजहों से, pickerUri को iframe में नहीं खोला जा सकता.
pollingConfig

object (PollingConfig)

सिर्फ़ आउटपुट के लिए. सुझाया गया कॉन्फ़िगरेशन, जिसका इस्तेमाल ऐप्लिकेशन को sessions.get को पोल करते समय करना चाहिए.

इस फ़ील्ड में सिर्फ़ तब जानकारी भरी जाती है, जब इस सेशन के लिए मीडिया आइटम नहीं चुने गए हैं. mediaItemsSet गलत है).
expireTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. इस सेशन (और इसके चुने गए मीडिया आइटम) का ऐक्सेस खत्म होने का समय.

आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़्ड होगा और इसमें 0, 3, 6 या 9 दशमलव अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
pickingConfig

object (PickingConfig)

ज़रूरी नहीं. इस सेशन के दौरान, उपयोगकर्ता के लिए फ़ोटो चुनने के अनुभव का कॉन्फ़िगरेशन.

sessions.create को कॉल करते समय, क्लाइंट ऐप्लिकेशन इसकी जानकारी देता है. इसके बाद, नया सेशन बनाए बिना इसमें बदलाव नहीं किया जा सकता.
mediaItemsSet

boolean

सिर्फ़ आउटपुट के लिए. अगर इसे true पर सेट किया गया है, तो इसका मतलब है कि इस सेशन के लिए मीडिया आइटम चुने गए हैं. साथ ही, आपका ऐप्लिकेशन mediaItems.list के ज़रिए चुने गए मीडिया आइटम की सूची का अनुरोध कर सकता है.

PollingConfig

एपीआई को पोल करने के लिए कॉन्फ़िगरेशन.

JSON के काेड में दिखाना 
{
  "pollInterval": string,
  "timeoutIn": string
}
फ़ील्ड
pollInterval

string (Duration format)

सिर्फ़ आउटपुट के लिए. पोल के अनुरोधों के बीच का सुझाया गया समय.

सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि 's' पर खत्म होती है. उदाहरण: "3.5s".
timeoutIn

string (Duration format)

सिर्फ़ आउटपुट के लिए. वह समय जिसके बाद क्लाइंट को पोलिंग बंद करनी चाहिए.

0 वैल्यू का मतलब है कि अगर क्लाइंट ने पहले से ही पोलिंग बंद नहीं की है, तो उसे पोलिंग बंद कर देनी चाहिए.

सेकंड में कुल अवधि, जिसमें दशमलव के बाद नौ अंक हो सकते हैं. यह अवधि 's' पर खत्म होती है. उदाहरण: "3.5s".

PickingConfig

इस सेशन के दौरान, उपयोगकर्ता के लिए प्रॉडक्ट चुनने के अनुभव के लिए, क्लाइंट से तय किया गया कॉन्फ़िगरेशन.

JSON के काेड में दिखाना 
{
  "maxItemCount": string
}
फ़ील्ड
maxItemCount

string (int64 format)

ज़रूरी नहीं. इस सेशन के दौरान, उपयोगकर्ता ज़्यादा से ज़्यादा कितने आइटम चुन सकता है. अगर कोई वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से 2000 होगी.

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

तरीके

create

 एक नया सेशन जनरेट करता है. इस दौरान, उपयोगकर्ता तीसरे पक्ष को ऐक्सेस देने के लिए फ़ोटो और वीडियो चुन सकता है.

delete

 बताए गए सेशन को मिटाता है.

get

 किसी सेशन के बारे में जानकारी दिखाता है.