הוספה של פריט מדיה אחד או יותר מספריית Google Photos של המשתמש לאלבום. את פריטי המדיה והאלבומים חייבים ליצור על ידי המפתח באמצעות ה-API.
פריטי מדיה מתווספים לסוף האלבום. אם צוינו פריטי מדיה מרובים, הם יתווספו לפי הסדר שנקבע בשיחה.
כל אלבום יכול להכיל עד 20,000 פריטי מדיה.
אפשר להוסיף לאלבום רק פריטי מדיה שנמצאים בספריית המשתמש. עבור אלבומים משותפים, האלבום חייב להיות בבעלות המשתמש או שהמשתמש הצטרף לאלבום כשותף עריכה.
אין תמיכה בהצלחה חלקית. הבקשה כולה תיכשל אם צוינו פריט מדיה או אלבום שאינם תקינים.
בקשת HTTP
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
albumId |
חובה. המזהה של |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "mediaItemIds": [ string ] } |
שדות | |
---|---|
mediaItemIds[] |
חובה. המזהים של ה- |
גוף התשובה
אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.sharing