Method: sessions.create

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

अगर उपयोगकर्ता के पास कोई चालू Google Photos खाता नहीं है, तो FAILED_PRECONDITION गड़बड़ी का कोड दिखता है.

अगर क्लाइंट ऐप्लिकेशन हर उपयोगकर्ता के लिए बहुत ज़्यादा सेशन बनाता है, तो RESOURCE_EXHAUSTED गड़बड़ी का मैसेज दिखता है. सामान्य परिस्थितियों में, क्लाइंट इन सीमाओं तक नहीं पहुंच सकते. हालांकि, हमारा सुझाव है कि क्लाइंट हर सेशन के बाद sessions.delete को कॉल करें, ताकि वे संसाधनों की सीमाओं के अंदर रहें.

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

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

POST https://photospicker.googleapis.com/v1/sessions

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

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

पैरामीटर
requestId

string

ज़रूरी नहीं. इस अनुरोध के लिए, क्लाइंट से मिला यूनीक आइडेंटिफ़ायर.

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

यह आईडी, UUID (वर्शन 4) स्ट्रिंग के फ़ॉर्मैट में होना चाहिए. साथ ही, यह इन ज़रूरी शर्तों के मुताबिक होना चाहिए:

  • इसमें उपयोगकर्ता की पहचान से जुड़ी कोई संवेदनशील जानकारी शामिल नहीं होनी चाहिए.
  • इसमें 32 हेक्साडेसिमल वर्ण होने चाहिए. इन्हें पांच ग्रुप में बांटा गया है और हायफ़न लगाकर अलग किया गया है. यह "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (या 8-4-4-4-12) फ़ॉर्मैट में होना चाहिए.

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

अनुरोध के मुख्य भाग में PickingSession का उदाहरण है.

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में PickingSession का नया इंस्टेंस शामिल किया जाता है.

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

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

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