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 概览。