管理媒体内容

除了在accessing媒体项后对其进行访问之外，您还可以更改其说明。

所需的授权范围

如需在媒体内容创建后更改其说明，请使用 photoslibrary.edit.appcreateddata 范围。

更改媒体内容说明

如需更改媒体内容的说明，请创建一个包含媒体内容标识符的 media items update call，并在请求中包含新的说明。

如需更改媒体项的说明，您的应用必须已上传媒体项，并且当前经过身份验证的用户必须是所有者。说明的长度不得超过 1000 个字符。

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
}