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)

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