Method: mediaItems.patch

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
mediaItem.id

string

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

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

פרמטרים
updateMask

string (FieldMask format)

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

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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