Method: albums.batchAddMediaItems

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

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

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

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
albumId

string

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

גוף הבקשה

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

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

string

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

גוף התשובה

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

היקפי הרשאה

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

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing