Method: photo.update

更新 Photo 的中繼資料,例如姿勢、地點關聯、連結等。不支援變更相片的像素。

系統只會使用 updateMask 欄位中指定的欄位。如果未顯示 updateMask,則更新內容會套用至所有欄位。

這個方法會傳回下列錯誤代碼:

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
photo.photoId.id

string

相片的專屬 ID。

查詢參數

參數
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 總覽