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