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