Method: mediaItems.batchGet

返回拥有指定媒体内容标识符的媒体内容列表。各项返回的顺序与提供的标识符相同。

HTTP 请求

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet

网址采用 gRPC 转码语法。

查询参数

参数
mediaItemIds[]

string

必需。要请求的媒体项的标识符。不得包含重复的标识符，也不得为空。一次调用中可检索的媒体内容数量上限为 50。

请求正文

请求正文必须为空。

响应正文

对检索媒体内容列表的响应。

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

JSON 表示法 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
字段
mediaItemResults[]

object (MediaItemResult)

仅供输出。检索到的媒体内容列表。请注意，即使对 mediaItems.batchGet 调用成功，该批次中的某些媒体内容也可能出现故障。这些失败情况会在每个 MediaItemResult.status 中指明。

授权范围

需要以下 OAuth 范围之一：

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

MediaItemResult

检索媒体内容的结果。

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

object (Status)

如果访问此媒体项时出错，系统会使用与错误相关的信息填充此字段。如需详细了解此字段，请参阅 Status。
mediaItem

object (MediaItem)

从用户媒体库中检索到的媒体内容。如果未出现错误且媒体内容已成功提取，则系统会填充此字段。