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