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
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata