更新 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 ( |
字段 | |
---|---|
updatePhotoRequests[] |
必需。 |
updatePhotoRequests[].photo |
必需。包含新元数据的 |
updatePhotoRequests[].updateMask |
必需。用于标识要更新的照片元数据中的字段的掩码。如果不存在,则此请求中的旧 以下字段有效:
|
响应正文
对批量更新一个或多个 Photos
的元数据的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"results": [
{
object ( |
字段 | |
---|---|
results[] |
每个 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/streetviewpublish
如需了解详情,请参阅 OAuth 2.0 概览。