Method: albums.batchAddMediaItems

将用户 Google 相册媒体库中的一项或多项媒体内容添加到影集。相应媒体内容和影集必须由开发者通过 API 创建。

系统会将媒体内容添加到影集末尾。如果指定了多个媒体项,它们将按此调用中指定的顺序进行添加。

每个影集最多可包含 20,000 项媒体内容。

只有用户媒体库中的媒体内容才能添加到影集。对于共享影集,该影集必须归用户所有,或者用户必须以协作者的身份加入该影集。

不支持部分成功。如果指定无效的媒体内容或影集,则整个请求都将失败。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
albumId

string

必需。添加媒体内容的 Album 的标识符。

请求正文

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

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

string

必需。要添加的 MediaItem 的标识符。一次调用中最多可添加 50 项媒体内容。

响应正文

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

授权范围

需要以下 OAuth 范围之一:

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