Method: providers.tasks.batchCreate

Cria e retorna um lote de novos objetos Task.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O recurso pai compartilhado por todas as tarefas. Esse valor precisa estar no formato providers/{provider}. O provider precisa ser o ID do projeto do Google Cloud. Por exemplo, sample-cloud-project. O campo pai nas mensagens de CreateTaskRequest precisa estar vazio ou corresponder a este campo.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
Campos
header

object (DeliveryRequestHeader)

Opcional. O cabeçalho de solicitação padrão da API Delivery. Observação: se você definir este campo, o campo de cabeçalho nas mensagens do CreateTaskRequest precisará estar vazio ou corresponder a este campo.

requests[]

object (CreateTaskRequest)

Obrigatório. A mensagem de solicitação que especifica os recursos a serem criados. Observação: é possível criar no máximo 500 tarefas em um lote.

Corpo da resposta

A mensagem de resposta BatchCreateTask.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
Campos
tasks[]

object (Task)

As tarefas criadas.

CreateTaskRequest

A mensagem de solicitação tasks.create.

Representação JSON
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
Campos
header

object (DeliveryRequestHeader)

Opcional. O cabeçalho de solicitação padrão da API Delivery.

parent

string

Obrigatório. Precisa estar no formato providers/{provider}. O provider precisa ser o ID do projeto do Google Cloud. Por exemplo, sample-cloud-project.

taskId

string

Obrigatório. O ID da tarefa precisa ser exclusivo, mas não pode ser um ID de rastreamento de frete. Para armazenar um ID de rastreamento de frete, use o campo trackingId. Várias tarefas podem ter o mesmo trackingId. Os IDs de tarefas estão sujeitos às seguintes restrições:

  • Precisa ser uma string Unicode válida.
  • Limitado a um tamanho máximo de 64 caracteres.
  • Normalizado de acordo com o Formulário C de normalização Unicode.
  • Não pode conter os seguintes caracteres ASCII: "/", ':', '?', ',' ou '#'.
task

object (Task)

Obrigatório. A entidade Task a ser criada. Ao criar uma tarefa, os seguintes campos são obrigatórios:

  • type
  • state (precisa ser definido como OPEN)
  • trackingId (não pode ser definido para tarefas UNAVAILABLE ou SCHEDULED_STOP, mas é obrigatório para todos os outros tipos de tarefas)
  • plannedLocation (opcional para UNAVAILABLE tarefas)
  • taskDuration

Observação: o campo name da tarefa é ignorado. Nenhum dos outros campos da tarefa pode ser definido. caso contrário, será retornado um erro.