Method: photos.list

列出属于用户的所有 Photos。

注意：仍在编入索引的最近创建的照片不会在响应中返回。

HTTP 请求

GET https://streetviewpublish.googleapis.com/v1/photos

网址采用 gRPC 转码语法。

查询参数

参数
view

enum (PhotoView)

必需。指定是否应在照片响应中返回照片字节的下载网址。
pageSize

integer

可选。要返回的照片数量上限。pageSize 必须为非负数。如果 pageSize 为零或未提供，则使用默认页面大小 100。如果属于用户的照片数量少于 pageSize，则响应中返回的照片数量可能少于 pageSize。
pageToken

string

可选。从上一个 photos.list 请求返回的 nextPageToken 值（如果有）。
filter

string

可选。过滤表达式。例如：placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw。

支持的过滤条件包括：placeId、min_latitude、max_latitude、min_longitude、max_longitude。如需了解详情，请参阅 https://google.aip.dev/160。
languageCode

string

可选。BCP-47 语言代码，例如“en-US”或“sr-Latn”。如需了解详情，请参阅 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如果未指定 languageCode，则使用用户对 Google 服务的语言偏好设置。

请求正文

请求正文必须为空。

响应正文

列出属于某个用户的所有照片的响应。

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

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

object (Photo)

照片列表。请求中的 pageSize 字段决定了返回的项数。
nextPageToken

string

用于检索下一页结果的令牌。如果列表中没有更多结果，则为空。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/streetviewpublish

如需了解详情，请参阅 OAuth 2.0 Overview。