返回具有指定媒体内容标识符的媒体内容列表。返回项的顺序与提供的标识符相同。
HTTP 请求
GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet
网址采用 gRPC 转码语法。
查询参数
参数 | |
---|---|
mediaItemIds[] |
必需。要请求的媒体内容的标识符。不得包含重复的标识符,也不得为空。一次调用中最多可检索到的媒体项数量为 50。 |
请求正文
请求正文必须为空。
响应正文
对检索媒体内容列表的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"mediaItemResults": [
{
object ( |
字段 | |
---|---|
mediaItemResults[] |
仅限输出。检索到的媒体内容列表。请注意,即使成功调用 mediaItems.batchGet,批次中的某些媒体项也可能失败。每个 |
授权范围
需要以下 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 |
从用户媒体库中检索到的媒体内容。如果未出现错误且媒体内容提取成功,系统会填充此字段。 |