Method: albums.batchAddMediaItems

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

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

כל אלבום יכול להכיל עד 20,000 פריטי מדיה.

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

בקשת HTTP

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

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

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

פרמטרים
albumId

string

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

גוף הבקשה

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

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

string

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

גוף התשובה

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

היקפי הרשאה

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

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