Method: mediaItems.patch

使用指定的 id 更新媒体项。系统仅会读取媒体内容的 iddescription 字段。相应媒体内容必须由开发者通过 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