ניהול פריטי המדיה

בנוסף לגישה לפריטי המדיה ואחזור שלהם אחרי שמעלים אותם, אפשר גם לשנות את התיאורים שלהם.

היקף ההרשאה הנדרש

כדי לשנות תיאורים של תוכן שנוצר על ידי האפליקציה, צריך את ההיקף photoslibrary.edit.appcreateddata. מידע נוסף על היקפים זמין במאמר היקפי הרשאה.

שינוי התיאורים של פריטי המדיה

כדי לשנות את התיאור של פריט מדיה, יוצרים בקשה מסוג media items update call עם המזהה של פריט המדיה, ומצרפים את התיאור החדש לבקשה.

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

REST

דוגמה לכותרת בקשת PATCH לעדכון תיאור של פריט מדיה:

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/media-item-id?updateMask=description

הבקשה הזו קובעת אילו נכסים מתעדכנים על ידי הכללת מסכת שדה, שמצוינת על ידי הפרמטר updateMask בכתובת ה-URL.

כוללים את התיאור החדש בגוף הבקשה:

{
  "description": "new-media-item-description"
}

אם הפעולה בוצעה ללא שגיאות, התשובה תחזיר את פריט המדיה המעודכן:

{
  "id": "media-item-id",
  "description": "new-media-item-description",
  "productUrl": "media-item-product-url",
  "baseUrl": "media-items-in-album",
  "mimeType": "mime-type-of-media",
  "mediaMetadata": {
    ...
  },
  "contributorInfo": {
    ...
  },
  "fileName": "item-filename"
}