Method: providers.tasks.batchCreate

Создает и возвращает пакет новых объектов Task .

HTTP-запрос

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate

URL-адрес использует синтаксис транскодирования gRPC .

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

Параметры
parent

string

Необходимый. Родительский ресурс, общий для всех задач. Это значение должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project . Родительское поле в сообщениях CreateTaskRequest должно быть либо пустым, либо соответствовать этому полю.

Тело запроса

Тело запроса содержит данные следующей структуры:

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

object ( DeliveryRequestHeader )

Необязательный. Стандартный заголовок запроса API доставки. Примечание. Если вы установите это поле, то поле заголовка в сообщениях CreateTaskRequest должно быть либо пустым, либо соответствовать этому полю.

requests[]

object ( CreateTaskRequest )

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

Тело ответа

Ответное сообщение BatchCreateTask .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
Поля
tasks[]

object ( Task )

Созданные Задачи.

CreateTaskRequest

Сообщение запроса tasks.create .

JSON-представление 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
Поля
header

object ( DeliveryRequestHeader )

Необязательный. Стандартный заголовок запроса API доставки.

parent

string

Необходимый. Должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project .

taskId

string

Необходимый. Идентификатор задачи должен быть уникальным, но не должен быть идентификатором отслеживания отправления. Чтобы сохранить идентификатор отслеживания отправления, используйте поле trackingId . Обратите внимание, что несколько задач могут иметь один и тот же trackingId . На идентификаторы задач распространяются следующие ограничения:

  • Должна быть допустимой строкой Unicode.
  • Ограничена максимальной длиной в 64 символа.
  • Нормализовано в соответствии с формой нормализации Unicode C.
  • Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».
task

object ( Task )

Необходимый. Сущность Task, которую необходимо создать. При создании Задачи обязательны следующие поля:

  • type
  • state (должно быть установлено на OPEN )
  • trackingId (не должен быть установлен для задач UNAVAILABLE или SCHEDULED_STOP , но необходим для всех остальных типов задач)
  • plannedLocation (необязательно для UNAVAILABLE задач)
  • taskDuration

Следующие поля могут быть установлены опционально:

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

Примечание. Поле name задачи игнорируется. Все остальные поля задачи не должны быть заданы; в противном случае возвращается ошибка.

,

Создает и возвращает пакет новых объектов Task .

HTTP-запрос

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate

URL-адрес использует синтаксис транскодирования gRPC .

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

Параметры
parent

string

Необходимый. Родительский ресурс, общий для всех задач. Это значение должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project . Родительское поле в сообщениях CreateTaskRequest должно быть либо пустым, либо соответствовать этому полю.

Тело запроса

Тело запроса содержит данные следующей структуры:

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

object ( DeliveryRequestHeader )

Необязательный. Стандартный заголовок запроса API доставки. Примечание. Если вы установите это поле, то поле заголовка в сообщениях CreateTaskRequest должно быть либо пустым, либо соответствовать этому полю.

requests[]

object ( CreateTaskRequest )

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

Тело ответа

Ответное сообщение BatchCreateTask .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
Поля
tasks[]

object ( Task )

Созданные Задачи.

CreateTaskRequest

Сообщение запроса tasks.create .

JSON-представление 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
Поля
header

object ( DeliveryRequestHeader )

Необязательный. Стандартный заголовок запроса API доставки.

parent

string

Необходимый. Должно быть в формате providers/{provider} . provider должен быть идентификатор проекта Google Cloud. Например, sample-cloud-project .

taskId

string

Необходимый. Идентификатор задачи должен быть уникальным, но не должен быть идентификатором отслеживания отправления. Чтобы сохранить идентификатор отслеживания отправления, используйте поле trackingId . Обратите внимание, что несколько задач могут иметь один и тот же trackingId . На идентификаторы задач распространяются следующие ограничения:

  • Должна быть допустимой строкой Unicode.
  • Ограничена максимальной длиной в 64 символа.
  • Нормализовано в соответствии с формой нормализации Unicode C.
  • Не может содержать следующие символы ASCII: «/», «:», «?», «,» или «#».
task

object ( Task )

Необходимый. Сущность Task, которую необходимо создать. При создании Задачи обязательны следующие поля:

  • type
  • state (должно быть установлено на OPEN )
  • trackingId (не должен быть установлен для задач UNAVAILABLE или SCHEDULED_STOP , но необходим для всех остальных типов задач)
  • plannedLocation (необязательно для UNAVAILABLE задач)
  • taskDuration

Следующие поля могут быть установлены опционально:

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

Примечание. Поле name задачи игнорируется. Все остальные поля задачи не должны быть заданы; в противном случае возвращается ошибка.