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