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