Method: albums.batchAddMediaItems

किसी एल्बम में, उपयोगकर्ता की Google Photos लाइब्रेरी में एक या उससे ज़्यादा मीडिया आइटम जोड़ता है. मीडिया आइटम और एल्बम, डेवलपर ने एपीआई के ज़रिए बनाए हों.

मीडिया आइटम एल्बम के आखिर में जोड़े जाते हैं. अगर एक से ज़्यादा मीडिया आइटम दिए गए हैं, तो उन्हें इस कॉल में तय क्रम में जोड़ा जाता है.

हर एल्बम में 20,000 मीडिया आइटम हो सकते हैं.

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

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

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

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems

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

पाथ पैरामीटर

पैरामीटर
albumId

string

ज़रूरी है. Album का आइडेंटिफ़ायर, जिसमें मीडिया आइटम जोड़े जाते हैं.

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

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "mediaItemIds": [
    string
  ]
}
फ़ील्ड
mediaItemIds[]

string

ज़रूरी है. जोड़े जाने वाले MediaItem के आइडेंटिफ़ायर. एक कॉल में ज़्यादा से ज़्यादा 50 मीडिया आइटम जोड़े जा सकते हैं.

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

जवाब सही होने पर, जवाब का मुख्य हिस्सा खाली होता है.

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

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

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing