Method: albums.list

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

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

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
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata