Method: albums.batchRemoveMediaItems

הסרה של פריט מדיה אחד או יותר שנוצר באפליקציה מאלבום ספציפי שנוצר באפליקציה. פריטי המדיה והאלבום חייבים להיות פרי יצירתו של המפתח באמצעות ה-API.

אין תמיכה בהצלחה חלקית. אם יצוין פריט מדיה או אלבום לא תקינים, הבקשה כולה תיכשל ולא תתבצע פעולה כלשהי באלבום.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
albumId

string

חובה. המזהה של ה-Album שממנו צריך להסיר את פריטי המדיה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "mediaItemIds": [
    string
  ]
}
שדות
mediaItemIds[]

string

חובה. המזהים של ה-MediaItem שרוצים להסיר.

אסור לכלול מזהי חזרה, והוא לא יכול להיות ריק. אפשר להסיר עד 50 פריטים של מדיה בקריאה אחת.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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