הוספה של פריט מדיה אחד או יותר בספרייה של המשתמש ב-Google Photos לאלבום. הפריטים והאלבומים של המדיה חייבים להיות פרי יצירתו של המפתח באמצעות ה-API.
פריטים של מדיה מתווספים לסוף האלבום. אם מציינים כמה פריטים של מדיה, הם מתווספים לפי הסדר שצוין בקריאה הזו.
כל אלבום יכול להכיל עד 20,000 פריטי מדיה.
אפשר להוסיף לאלבום רק פריטי מדיה שנמצאים בספרייה של המשתמש. באלבומים משותפים, האלבום צריך להיות בבעלות המשתמש או שהמשתמש צריך להצטרף לאלבום כשותף עריכה.
אין תמיכה בהצלחה חלקית. הבקשה כולה תיכשל אם יצוין פריט מדיה או אלבום לא חוקיים.
בקשת HTTP
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems
כתובת ה-URL משתמשת בתחביר של Transcoding של 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
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata