Method: albums.batchRemoveMediaItems

لإزالة عنصر وسائط واحد أو أكثر من ألبوم محدّد. يجب أن يكون المطوّر هو من أنشأ عناصر الوسائط والألبوم من خلال واجهة برمجة التطبيقات.

بالنسبة إلى الألبومات التي تمت مشاركتها، لا يمكن تنفيذ هذا الإجراء إلا لملفات الوسائط التي أضافها هذا المستخدم إلى الألبوم، أو لجميع ملفات الوسائط إذا أنشأ هذا المستخدم الألبوم.

ولا يمكن تحقيق النجاح الجزئي. سيفشل الطلب بالكامل ولن يتم تنفيذ أي إجراء على الألبوم إذا تم تحديد عنصر وسائط أو ألبوم غير صالح.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز 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