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