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 的執行例項。