Method: mediaItems.patch

使用指定的 id 更新媒体内容。系统仅会读取媒体内容的 id 和 description 字段。媒体项必须由开发者通过 API 创建，并且必须归用户所有。

HTTP 请求

PATCH https://photoslibrary.googleapis.com/v1/mediaItems/{mediaItem.id}

网址采用 gRPC 转码语法。

路径参数

参数
mediaItem.id

string

媒体项的标识符。这是一个永久标识符，可用于在会话之间标识此媒体项。

查询参数

参数
updateMask

string (FieldMask format)

必需。指明要更新的提供的媒体项中的哪些字段。唯一的有效值为 description。

这是以英文逗号分隔的完全限定字段名称列表。示例："user.displayName,photo"。

请求正文

请求正文包含一个 MediaItem 实例。

响应正文

如果成功，则响应正文包含一个 MediaItem 实例。

授权范围

需要以下 OAuth 作用域：

  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata