Method: albums.batchRemoveMediaItems

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

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

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

בקשת 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