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

支持的过滤条件包括:placeIdmin_latitudemax_latitudemin_longitudemax_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 概览