Method: mediaItems.list

列出用户 Google 相册媒体库中的所有媒体内容。

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
pageSize

integer

响应中可返回的媒体项数量上限。返回的媒体内容数量可能会少于指定数量。默认 pageSize 为 25，最大值为 100。
pageToken

string

获得下一页结果的延续令牌。将此属性添加到请求中，即可返回 pageToken 后面的行。在对 listMediaItems 请求的响应中，pageToken 应该是 nextPageToken 参数中返回的值。

请求正文

请求正文必须为空。

响应正文

用户 Google 相册媒体库中所有媒体内容的列表。

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

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

object (MediaItem)

仅限输出。用户媒体库中的媒体内容列表。
nextPageToken

string

仅限输出。用于获取下一组媒体内容的令牌。只有存在此令牌，才能表明下一个请求中是否有更多可用媒体项。

授权范围

需要以下 OAuth 范围之一：

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