Method: selection.v1.projects.selectedRoutes.batchUpdate

Обновляет несколько ресурсов SelectedRoute, указанных по названиям.

HTTP-запрос

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

URL имеет синтаксис gRPC Transcoding.

Параметры пути

Параметры
parent

string

Обязательно. Ресурс проекта, общий для всех выбранных маршрутов в пакете. Это необходимо, поскольку пакетный запрос поддерживает только один parent. Формат: projects/{project}

Тело запроса

Ниже приведена структура данных в теле запроса.

JSON-представление
{
  "requests": [
    {
      object (UpdateSelectedRouteRequest)
    }
  ],
  "updateMask": string
}
Поля
requests[]

object (UpdateSelectedRouteRequest)

Обязательно. Сообщение запроса, указывающее выбранный маршрут для обновления. За один раз можно обновить не более 1000 маршрутов. Родительский ресурс каждого запроса должен быть пустым или соответствовать верхнему уровню parent.

updateMask

string (FieldMask format)

Необязательное поле. Список полей, которые нужно обновить, общий для всех дочерних запросов в пакете.

Пути к полям указываются относительно SelectedRoute. Обновлять нужно только displayName, routeAttributes, dynamicRouting и dynamicRoute (включая origin, destination и intermediates).

Пример: "displayName,routeAttributes,dynamicRouting,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

Требуется следующее разрешение IAM для ресурса parent:

  • 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. Обновлять нужно только displayName, routeAttributes, dynamicRouting и dynamicRoute (включая origin, destination и intermediates).

Пример: "displayName,routeAttributes,dynamicRouting,dynamicRoute".

Если указано значение *, выполняется полная замена всех обновляемых полей.

Если параметр updateMask не указан, обновляются все поля, которые можно обновить и которые заполнены в selectedRoute.