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