Method: mediaItems.batchCreate

在用户的 Google 相册媒体库中创建一项或多项媒体内容。

这是创建媒体内容的第二步。如需详细了解第 1 步（将原始字节上传到 Google 服务器），请参阅上传媒体内容。

此调用会将媒体内容添加到媒体库。如果指定了影集 id，则此调用也会将媒体内容添加到该影集。每个影集最多可包含 20,000 项媒体内容。默认情况下，媒体内容会添加到媒体库或影集的末尾。

如果同时定义了影集 id 和位置，则媒体内容会添加到影集的指定位置。

如果调用包含多个媒体项，这些媒体项会添加到指定位置。如果您不是所有者，在您并非所有者的共享影集中创建媒体内容，则无法定位媒体内容。这样做会导致 BAD REQUEST 错误。

HTTP 请求

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

网址采用 gRPC 转码语法。

请求正文

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

JSON 表示法 
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
字段
albumId

string

添加了媒体内容的影集的标识符。这些媒体内容也会添加到用户的媒体库中。这是一个可选字段。
newMediaItems[]

object (NewMediaItem)

必需。要创建的媒体项的列表。每次调用最多 50 项媒体内容。
albumPosition

object (AlbumPosition)

媒体内容在影集中的添加位置。如果未指定，则媒体内容将添加到影集末尾（根据默认值，即 LAST_IN_ALBUM）。如果已设置此字段，但未指定 albumId，则请求会失败。如果您已设置此字段，但不是共享影集的所有者，此请求也会失败。

响应正文

已创建媒体项的列表。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
字段
newMediaItemResults[]

object (NewMediaItemResult)

仅供输出。已创建媒体项的列表。

授权范围

需要以下 OAuth 范围之一：

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

NewMediaItem

在用户的 Google 相册账号中创建的新媒体内容。

JSON 表示法 
{
  "description": string,

  // Union field new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
字段
description

string

媒体项的说明。此信息会在 Google 相册应用的内容信息部分向用户显示。长度必须少于 1000 个字符。仅包含用户撰写的文字。说明应该添加背景信息，帮助用户了解媒体内容。请勿包含任何自动生成的字符串，例如文件名、标签和其他元数据。
联合字段 new_media_item_type。新媒体内容可有多种不同类型，具体取决于上传路径。目前支持的上传操作仅使用简单的媒体内容路径。new_media_item_type 只能是下列其中一项：
simpleMediaItem

object (SimpleMediaItem)

通过包含的 uploadToken 上传的新媒体项。

SimpleMediaItem

通过上传令牌在 Google 相册中创建的简单媒体内容。

JSON 表示法 
{
  "uploadToken": string,
  "fileName": string
}
字段
uploadToken

string

标识已上传到 Google 的媒体字节的令牌。
fileName

string

带媒体项扩展名的文件名。此图片会在 Google 相册中向用户显示。如果设置了此字段，则忽略在字节上传流程中指定的文件名。文件名（包括文件扩展名）不应超过 255 个字符。这是一个可选字段。

NewMediaItemResult

创建新媒体项的结果。

JSON 表示法 
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
字段
uploadToken

string

用于创建此新（简单）媒体项的上传令牌。仅当媒体内容简单且需要单个上传令牌时填充。
status

object (Status)

如果创建此媒体内容期间出现错误，系统会使用与错误相关的信息填充此字段。如需详细了解此字段，请参阅 Status。
mediaItem

object (MediaItem)

使用上传令牌创建的媒体内容。如果未出现错误且媒体项已成功创建，则系统会填充此字段。