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

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

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

כדי לשנות את התיאורים של פריטי המדיה אחרי היצירה שלהם, אפשר להשתמש היקף הרשאות אחד (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"
}

Java

try {
  // Update the description of the media item.
  // The new description must not be null.
  MediaItem updatedItem = photosLibraryClient.updateMediaItemDescription(mediaItem, "new-media-item-description");
} catch (ApiException e) {
  // Handle error
}

PHP

try {

    // ID of the media item to update.
    $mediaItemId = "MEDIA_ITEM_ID";

    // New description of the media item.
    $newDescription = "new-media-item-description";

    // Update the description of the media item identified.
    $mediaItem = $photosLibraryClient->updateMediaItemDescription($mediaItemId, $newDescription);

} catch (\Google\ApiCore\ApiException $e) {
    // Handle error
}