Method: mediaItems.list

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

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
pageSize

integer

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

string

获得下一页结果的延续令牌。将该令牌添加到请求后即可返回 pageToken 之后的行。pageToken 应为对 listMediaItems 请求的响应中 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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals