管理媒體項目

除了在上傳後accessing媒體項目之外，也可以變更其說明。

必要的授權範圍

如要在建立媒體項目後變更說明，請使用 photoslibrary.edit.appcreateddata 範圍。

變更媒體項目說明

如要變更媒體項目的說明，請使用媒體項目的 ID 建立 media items update call，並在要求中加入新的說明。

如要變更媒體項目的說明，應用程式必須上傳媒體項目，而且目前驗證的使用者必須是擁有者。說明長度不得超過 1,000 個字元。

REST

以下是 PATCH 要求標頭，可用於更新媒體項目說明：

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

這項要求會在網址中加入 updateMask 參數來表示的欄位遮罩，藉此判斷要更新哪些屬性。

在要求內文中加入新說明：

{
  "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
}