Method: albums.batchRemoveMediaItems

从指定影集中移除一项或多项媒体内容。媒体内容和影集必须由开发者通过 API 创建。

对于共享影集，只有此用户添加到影集的媒体内容支持此操作；如果影集是由此用户创建的，则所有媒体内容支持此操作。

不支持部分成功。如果指定了无效的媒体内容或影集，整个请求都将失败，并且不会对影集执行任何操作。

HTTP 请求

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchRemoveMediaItems

网址采用 gRPC 转码语法。

路径参数

参数
albumId

string

必需。要从中移除媒体内容的 Album 的标识符。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "mediaItemIds": [
    string
  ]
}
字段
mediaItemIds[]

string

必需。要移除的 MediaItem 的标识符。

不得包含重复的标识符，也不得为空。一次调用中最多可以移除 50 项媒体内容。

响应正文

如果成功，则响应正文为空。

授权范围

需要以下 OAuth 作用域：

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