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 Overview。