Method: providers.vehicles.update

將更新後的車輛資料寫入 Fleet Engine。

更新 Vehicle 時,下列欄位是由伺服器管理,因此無法更新:

  • currentTrips
  • availableCapacity
  • currentRouteSegmentVersion
  • waypointsVersion

無法更新車輛「name」。

如果 attributes 欄位更新,則「所有」車輛屬性都會替換成要求中提供的屬性。如果只想更新部分屬性,請參閱 vehicles.updateAttributes 方法。同樣地,waypoints 欄位可以更新,但必須包含車輛目前使用的所有路線控點,不得包含其他路線控點。

HTTP 要求

PUT https://fleetengine.googleapis.com/v1/{name=providers/*/vehicles/*}

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

路徑參數

參數
name

string

必要欄位。格式須為 providers/{provider}/vehicles/{vehicle}。{provider} 必須是呼叫此呼叫的服務帳戶所屬 Google Cloud 專案的專案 ID (例如 sample-cloud-project)。

查詢參數

參數
header

object (RequestHeader)

標準 Fleet Engine 要求標頭。

updateMask

string (FieldMask format)

必要欄位。欄位遮罩,指出要更新 Vehicle 的哪些欄位。至少須提供一個欄位名稱。

這是以半形逗號分隔的完整欄位名稱清單。範例:"user.displayName,photo"

要求主體

要求主體包含 Vehicle 的例項。

回應主體

如果成功,回應主體會包含 Vehicle 的執行例項。