- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
यह उपयोगकर्ता को दिखाए जाने वाले सभी एल्बम, Google Photos ऐप्लिकेशन के एल्बम टैब में दिखाता है.
एचटीटीपी अनुरोध
GET https://photoslibrary.googleapis.com/v1/albums
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
pageSize |
जवाब में लौटाए जाने वाले एल्बम की ज़्यादा से ज़्यादा संख्या. हो सकता है कि आपको तय की गई संख्या से कम एल्बम दिखें. |
pageToken |
नतीजों का अगला पेज पाने के लिए, जारी रखने वाला टोकन. इसे अनुरोध में जोड़ने पर, |
excludeNonAppCreatedData |
अगर यह नीति सेट की जाती है, तो नतीजों में वे मीडिया आइटम शामिल नहीं होंगे जिन्हें इस ऐप्लिकेशन से नहीं बनाया गया है. डिफ़ॉल्ट रूप से गलत पर सेट होती है (सभी एल्बम लौटाए जाते हैं). अगर photoslibrary.readonly.appcreateddata स्कोप का इस्तेमाल किया जाता है, तो इस फ़ील्ड को अनदेखा कर दिया जाता है. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
जिन एल्बम के लिए अनुरोध किया गया है उनकी सूची.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"albums": [
{
object ( |
फ़ील्ड | |
---|---|
albums[] |
सिर्फ़ आउटपुट के लिए. उपयोगकर्ता के Google Photos ऐप्लिकेशन के एल्बम टैब में दिखने वाले एल्बम की सूची. |
nextPageToken |
सिर्फ़ आउटपुट के लिए. एल्बम का अगला सेट पाने के लिए इस्तेमाल किया जाने वाला टोकन. इस अनुरोध के लिए, वापस पाने के लिए और एल्बम उपलब्ध होने पर यह जानकारी अपने-आप भर जाती है. |
अनुमति के दायरे
इसके लिए, OAuth के इनमें से किसी एक स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata