Method: mediaItems.patch

מעדכנים את פריט המדיה עם הערך id שצוין. המערכת קוראת רק את השדות id ו-description של פריט המדיה. פריט המדיה צריך להיות נוצר על ידי המפתח באמצעות ה-API, והוא צריך להיות בבעלות המשתמש.

בקשת HTTP

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/{mediaItem.id}

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
mediaItem.id

string

מזהה של פריט המדיה. זהו מזהה קבוע שיכול לשמש לזיהוי פריט המדיה הזה בין סשנים.

פרמטרים של שאילתה

פרמטרים
updateMask

string (FieldMask format)

חובה. מציינים אילו שדות בפריט המדיה צריך לעדכן. הערך החוקי היחיד הוא description.

זוהי רשימה מופרדת בפסיקים של שמות מלאים של שדות. דוגמה: "user.displayName,photo"

גוף הבקשה

גוף הבקשה מכיל מופע של MediaItem.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של MediaItem.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata