管理媒体内容

除了在上传媒体内容后访问和检索这些内容之外，您还可以更改其说明。

必需的授权范围

如需更改应用创建的内容的说明，您需要拥有 photoslibrary.edit.appcreateddata 权限范围。如需详细了解范围，请参阅授权范围。

更改媒体项说明

如需更改媒体内容的说明，请使用媒体内容的标识符发出 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"
}