Method: photos.batchUpdate

更新 Photos 的元数据，例如姿势、地点关联、连接等。不支持更改照片的像素。

请注意，如果 photos.batchUpdate 失败，则表示缺少关键字段或存在身份验证错误。即使 photos.batchUpdate 成功，批量处理中的个别照片也可能会出现问题。这些故障在 BatchUpdatePhotosResponse.results 的每个 PhotoResponse.status 中指定。如需了解每张照片可能发生的具体失败情况，请参阅 photo.update。

仅使用 updateMask 字段中指定的字段。如果未提供 updateMask，则更新将应用于所有字段。

一个 BatchUpdatePhotosRequest 中的 UpdatePhotoRequest 消息数量不得超过 20。

注意：如需更新 Pose.altitude，还必须填写 Pose.latLngPair。否则，请求将失败。

HTTP 请求

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
字段
updatePhotoRequests[]

object

必需。UpdatePhotoRequests的列表。
updatePhotoRequests[].photo

object (Photo)

必需。包含新元数据的 Photo 对象。
updatePhotoRequests[].updateMask

string (FieldMask format)

必需。用于标识要更新的照片元数据中的字段的掩码。如果未提供，则此请求中的新 Photo 元数据将完全替换旧 Photo 元数据。如果指定了无效字段，更新会失败。您可以在以英文逗号分隔的列表中指定多个字段。

以下字段有效：

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

注意：如果 updateMask 包含重复字段，则整个重复值集会被新内容替换。例如，如果 updateMask 包含 connections 且 UpdatePhotoRequest.photo.connections 为空，则所有连接都会被移除。

响应正文

对一个或多个 Photos 的元数据进行批量更新的响应。

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

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

object (PhotoResponse)

每个单独的 Photo 的结果列表（按请求顺序排列）。

授权范围

需要以下 OAuth 范围：

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

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