将用户 Google 相册媒体库中的一项或多项媒体内容添加到影集。媒体内容和影集必须由开发者通过 API 创建。
媒体内容会添加到影集末尾。如果指定了多个媒体项,将按照此调用中指定的顺序进行添加。
每个影集最多可包含 20,000 项媒体内容。
您只能将用户媒体库中的媒体内容添加到影集。对于共享影集,影集必须归用户所有,或者用户必须是作为协作者加入影集。
不支持部分成功。如果指定了无效的媒体内容或影集,整个请求将会失败。
HTTP 请求
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
albumId |
必需。添加媒体内容的 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "mediaItemIds": [ string ] } |
字段 | |
---|---|
mediaItemIds[] |
必需。要添加的 |
响应正文
如果成功,则响应正文为空。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.sharing