Method: mediaItems.list

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

如果会话中还没有任何已选媒体项，因此无法返回媒体内容，系统会返回 FAILED_PRECONDITION 错误。在这种情况下，在受限输入设备上运行的应用应呈现一个编码会话的 pickerUri 的二维码，提示用户在 Google 相册选择器界面中扫描该代码并选择媒体项。在等待用户选取其项时，客户端应每 pollingConfig.pollInterval 轮询一次 sessions.get，直到 sessions.get 响应中的 pickedItemsSet = true 为止。此时，客户端可以继续调用 mediaItems.list 并期望收到成功响应。

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 RPC 的响应。

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

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

object (PickedMediaItem)

包含所选媒体项的页面。
nextPageToken

string

一个令牌，可作为 pageToken 发送，以检索 mediaItems.list 请求中的下一页。

授权范围

需要以下 OAuth 范围：

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