Method: albums.list

आपके ऐप्लिकेशन से बनाए गए सभी एल्बम की सूची दिखाता है.

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

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

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

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

पैरामीटर
pageSize

integer

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

string

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

boolean

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

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

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

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

जिन एल्बम के लिए अनुरोध किया गया है उनकी सूची.

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

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

object (Album)

सिर्फ़ आउटपुट के लिए. उपयोगकर्ता के Google Photos ऐप्लिकेशन के एल्बम टैब में दिखने वाले एल्बम की सूची.
nextPageToken

string

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

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

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

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