Method: selection.v1.projects.selectedRoutes.batchUpdate

根據名稱更新多個 SelectedRoute 資源。

HTTP 要求

POST https://roads.googleapis.com/selection/v1/{parent=projects/*}/selectedRoutes:batchUpdate

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

路徑參數

參數
parent

string

必填。批次中所有選定路徑共用的專案資源。這是必要條件,因為批次要求僅支援單一 parent。格式:projects/{project}

要求主體

要求主體會包含結構如下的資料:

JSON 表示法
{
  "requests": [
    {
      object (UpdateSelectedRouteRequest)
    }
  ],
  "updateMask": string
}
欄位
requests[]

object (UpdateSelectedRouteRequest)

必填。要求訊息,指定要更新的所選路線。最多可批次更新 1,000 條所選路線。每個要求的上層資源必須為空白,或與頂層 parent 相符。

updateMask

string (FieldMask format)

(選用步驟) 批次中所有子項要求共用的待更新欄位清單。

欄位路徑是 SelectedRoute 的相對路徑。您只需要更新 displayNamerouteAttributesdynamicRoute (包括 origindestinationintermediates)。

範例:"displayName,routeAttributes,dynamicRoute"

如果已設定,這個 updateMask 會套用至未指定自身 updateMask 的任何子項要求。如果指定 *,系統會完整替換所有可更新的欄位。如果同時設定批次和子項要求層級的 updateMask 欄位,則兩者必須相符。

如果省略這個值,系統會使用子項要求的 updateMask。如果省略子項要求的 updateMask,系統會將子項要求 selectedRoute 中填入的所有可更新欄位視為要更新。

回應主體

更新多個 SelectedRoute 的回應。

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

JSON 表示法
{
  "selectedRoutes": [
    {
      object (SelectedRoute)
    }
  ]
}
欄位
selectedRoutes[]

object (SelectedRoute)

已更新 SelectedRoute 項資源。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/cloud-platform

IAM 權限

需要 parent 資源的下列 IAM 權限:

  • roads.selectedRoutes.batchUpdate

詳情請參閱 IAM 說明文件

UpdateSelectedRouteRequest

更新 SelectedRoute 的要求。

JSON 表示法
{
  "selectedRoute": {
    object (SelectedRoute)
  },
  "updateMask": string
}
欄位
selectedRoute

object (SelectedRoute)

必填。更新「SelectedRoute」。路線的 name 欄位用於識別要更新的路線。格式:projects/{project}/selectedRoutes/{selectedRoute}

updateMask

string (FieldMask format)

(選用步驟) 要更新的欄位清單。

欄位路徑是 SelectedRoute 的相對路徑。您只能更新 displayNamerouteAttributesdynamicRoute (包括 origindestinationintermediates)。

範例:"displayName,routeAttributes,dynamicRoute"

如果指定 *,系統會完整替換所有可更新的欄位。

如果省略 updateMask,系統會更新 selectedRoute 中填入的所有可更新欄位。