Method: mediaItems.list

返回用户在指定会话期间选择的媒体内容列表。

如果用户尚未为指定会话选择媒体内容，则会返回 FAILED_PRECONDITION 错误。在这种情况下，您的应用应轮询 sessions.get，直到会话准备就绪，然后再重试此方法。

HTTP 请求

GET https://photospicker.googleapis.com/v1/mediaItems

网址采用 gRPC 转码语法。

查询参数

参数
sessionId

string

必需。Google 为此会话生成的标识符。
pageSize

integer

可选。要返回的媒体内容数量上限。

服务返回的结果数量可能少于此值（包括零个结果）。如果未指定或设为 0，则最多返回 50 个媒体项。最大值为 100；高于 100 的值将强制转换为 100。负值将导致 INVALID_ARGUMENT 错误。
pageToken

string

可选。从之前的 mediaItems.list 调用接收的页面令牌。利用其进行后续页面检索。

请求正文

请求正文必须为空。

响应正文

对 mediaItems.list 方法的响应。

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

JSON 表示法 
{
  "mediaItems": [
    {
      object (PickedMediaItem)
    }
  ],
  "nextPageToken": string
}
字段
mediaItems[]

object (PickedMediaItem)

包含所选媒体内容的页面。
nextPageToken

string

如果设置了此字段，则可以在后续的 mediaItems.list 调用中将其用作 pageToken，以检索所选媒体项的下一页。

如果省略此字段，则不存在后续页面。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly