Method: mediaItems.batchGet

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

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

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

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

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

पैरामीटर
mediaItemIds[]

string

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

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

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

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

मीडिया आइटम की सूची फिर से पाने का जवाब.

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

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

object (MediaItemResult)

सिर्फ़ आउटपुट के लिए. वापस लाई गई मीडिया आइटम की सूची. ध्यान दें कि MediaItem.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

MediaItemResult

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

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

object (Status)

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

object (MediaItem)

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