מוצג לך תיעוד של הגרסה הקודמת של Google Photos Library API.
Method: albums.patch
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מעדכנים את האלבום עם id
שצוין. רק השדות id
, title
ו-coverPhotoMediaItemId
של האלבום ייקראו. האלבום חייב להיות נוצר על ידי המפתח באמצעות ה-API, והוא חייב להיות בבעלותו של המשתמש.
בקשת HTTP
PATCH https://photoslibrary.googleapis.com/v1/albums/{album.id}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים |
album.id |
string
המזהה של האלבום. זהו מזהה קבוע שאפשר להשתמש בו בין סשנים כדי לזהות את האלבום הזה.
|
פרמטרים של שאילתה
פרמטרים |
updateMask |
string (FieldMask format)
חובה. מציינים אילו שדות באלבום שסופק צריך לעדכן. הערכים החוקיים היחידים הם title ו-coverPhotoMediaItemId . זוהי רשימה מופרדת בפסיקים של שמות שדות מלאים. דוגמה: "user.displayName,photo"
|
גוף הבקשה
גוף הבקשה מכיל מופע של Album
.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Album
.
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],["This describes updating an album using a PATCH request to `https://photoslibrary.googleapis.com/v1/albums/{album.id}`. The `album.id` path parameter identifies the target album. The `updateMask` query parameter, with values `title` or `coverPhotoMediaItemId`, specifies which album fields to update. The request body contains the updated album information, while the successful response body returns the updated album. This operation requires the `https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata` authorization scope. Only albums created via the API and owned by the user can be modified.\n"],null,[]]