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 包含 connections，且 UpdatePhotoRequest.photo.connections 為空白，則系統會移除所有連線。

回應主體

回應一或多個 Photos 的中繼資料批次更新。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
欄位
results[]

object (PhotoResponse)

每個 Photo 的結果清單都會按照要求的順序更新。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。