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