Method: mediaItems.list

उपयोगकर्ता की Google Photos लाइब्रेरी में मौजूद सभी मीडिया आइटम की सूची बनाता है.

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

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

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

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

पैरामीटर
pageSize

integer

जवाब में दिखाए जाने वाले मीडिया आइटम की ज़्यादा से ज़्यादा संख्या. हो सकता है कि तय संख्या से कम मीडिया आइटम लौटाए जाएं. डिफ़ॉल्ट pageSize 25 है. यह ज़्यादा से ज़्यादा 100 हो सकता है.
pageToken

string

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

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

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

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

उपयोगकर्ता की Google Photos लाइब्रेरी में मौजूद सभी मीडिया आइटम की सूची.

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

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

object (MediaItem)

सिर्फ़ आउटपुट के लिए. उपयोगकर्ता की लाइब्रेरी में मौजूद मीडिया आइटम की सूची.
nextPageToken

string

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

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

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

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