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 包含 connectionsUpdatePhotoRequest.photo.connections 为空,则系统会移除所有连接。

响应正文

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

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

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

object (PhotoResponse)

更新后的每个 Photo 的结果列表,顺序与请求相同。

授权范围

需要以下 OAuth 作用域:

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

有关详情,请参阅 OAuth 2.0 概览