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
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata