Method: photo.update

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

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

此方法会返回以下错误代码：

HTTP 请求

PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}

网址采用 gRPC 转码语法。

路径参数

参数
photo.photoId.id

string

照片的唯一标识符。

查询参数

参数
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 为空，则所有连接都会被移除。

请求正文

请求正文包含一个 Photo 实例。

响应正文

如果成功，则响应正文包含一个 Photo 实例。

授权范围

需要以下 OAuth 范围：

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

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