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

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