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

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

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

כדי לשנות את התיאורים של פריטי מדיה אחרי שהם נוצרים, השתמשו בהיקף photoslibrary.edit.appcreateddata.

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

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

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

REST

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

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
}