Method: albums.batchRemoveMediaItems

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

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
albumId

string

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

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

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

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

string

ज़रूरी है. MediaItem के आइडेंटिफ़ायर हटाए जाने हैं.

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

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

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

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

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

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata