Method: photos.batchGet

获取指定的 Photo 批次的元数据。

请注意，如果 photos.batchGet 失败，则表示关键字段缺失或出现身份验证错误。即使 photos.batchGet 成功，批次中的单张照片也可能失败。这些失败情况在 BatchGetPhotosResponse.results 中的每个 PhotoResponse.status 中指定。如需了解每张照片可能会出现的具体失败情况，请参阅 photo.get。

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
photoIds[]

string

必需。Photos 的 ID。对于 HTTP GET 请求，网址查询参数应为 photoIds=<id1>&photoIds=<id2>&...。
view

enum (PhotoView)

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

string

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

请求正文

请求正文必须为空。

响应正文

对 Photos 的批量获取的响应。

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

JSON 表示法 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
字段
results[]

object (PhotoResponse)

请求单个 Photo 的结果列表，顺序与 photos.batchGet 中的请求顺序相同。

授权范围

需要以下 OAuth 作用域：

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

有关详情，请参阅 OAuth 2.0 概览。