Method: albums.batchAddMediaItems

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

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

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

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

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

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

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

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

पाथ के पैरामीटर

पैरामीटर
albumId

string

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

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

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "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