Method: sharedAlbums.list

उपयोगकर्ता के Google Photos ऐप्लिकेशन के 'शेयर करना' टैब में मौजूद, शेयर किए गए सभी एल्बम की सूची दिखाता है.

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

GET https://photoslibrary.googleapis.com/v1/sharedAlbums

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

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

पैरामीटर
pageSize

integer

जवाब में ज़्यादा से ज़्यादा कितने एल्बम दिखाने हैं. हो सकता है कि आपको तय की गई संख्या से कम एल्बम दिखें. डिफ़ॉल्ट pageSize 20 है. हालांकि, यह ज़्यादा से ज़्यादा 50 हो सकता है.

pageToken

string

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

excludeNonAppCreatedData

boolean

अगर यह सेट है, तो नतीजों में वे मीडिया आइटम शामिल नहीं किए जाते जिन्हें इस ऐप्लिकेशन ने नहीं बनाया है. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है (सभी एल्बम दिखाए जाते हैं). photoslibrary.readonly.appcreateddata स्कोप का इस्तेमाल करने पर, इस फ़ील्ड को अनदेखा कर दिया जाता है.

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

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

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

शेयर किए गए उन एल्बम की सूची जिनका ऐक्सेस मांगा गया है.

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

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

object (Album)

सिर्फ़ आउटपुट के लिए. शेयर किए गए एल्बम की सूची.

nextPageToken

string

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

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

इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals