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