Method: mediaItems.batchGet

दिए गए मीडिया आइटम आइडेंटिफ़ायर के लिए, मीडिया आइटम की सूची दिखाता है. आइटम उसी क्रम में दिखाए जाते हैं जिस क्रम में आइडेंटिफ़ायर दिए गए हैं.

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

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

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

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

पैरामीटर
mediaItemIds[]

string

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

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

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

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

मीडिया आइटम की सूची पाने का रिस्पॉन्स.

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

JSON के काेड में दिखाना 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
फ़ील्ड
mediaItemResults[]

object (MediaItemResult)

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

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

इसके लिए, 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

MediaItemResult

मीडिया आइटम को वापस लाने का नतीजा.

JSON के काेड में दिखाना 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
फ़ील्ड
status

object (Status)

अगर इस मीडिया आइटम को ऐक्सेस करते समय कोई गड़बड़ी हुई है, तो इस फ़ील्ड में गड़बड़ी से जुड़ी जानकारी अपने-आप भर जाएगी. इस फ़ील्ड के बारे में ज़्यादा जानकारी के लिए, Status देखें.
mediaItem

object (MediaItem)

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