Method: providers.tasks.batchCreate
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 CreateTaskRequest precisa estar vazio ou corresponder a esse campo.
|
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
| Campos |
header |
object (DeliveryRequestHeader)
Opcional. O cabeçalho de solicitação padrão da API Delivery. Observação: se você definir esse campo, o campo de cabeçalho nas mensagens CreateTaskRequest precisará estar vazio ou corresponder a esse 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 |
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 remessa. Para armazenar um ID de rastreamento de remessa, 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 comprimento máximo de 64 caracteres.
- Normalizado de acordo com o Formulário de normalização C do Unicode.
- Não pode conter nenhum dos 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:
typestate (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 tarefa.plannedLocation (opcional para tarefas UNAVAILABLE)taskDuration Os campos a seguir podem ser definidos opcionalmente:
targetTimeWindowtaskTrackingViewConfigattributes Observação: o campo name da tarefa é ignorado. Todos os outros campos da tarefa não podem ser definidos. Caso contrário, um erro será retornado.
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eCreates up to 500 \u003ccode\u003eTask\u003c/code\u003e objects at once using the \u003ccode\u003eBatchCreateTasks\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eRequires a \u003ccode\u003eparent\u003c/code\u003e resource in the URL path, indicating the Google Cloud Project ID.\u003c/p\u003e\n"],["\u003cp\u003eThe request body includes an optional \u003ccode\u003eheader\u003c/code\u003e and a required list of \u003ccode\u003erequests\u003c/code\u003e, each defining a \u003ccode\u003eTask\u003c/code\u003e to create.\u003c/p\u003e\n"],["\u003cp\u003eThe response returns a list of created \u003ccode\u003eTask\u003c/code\u003e objects within the \u003ccode\u003etasks\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eEach individual \u003ccode\u003eCreateTaskRequest\u003c/code\u003e requires a \u003ccode\u003etaskId\u003c/code\u003e, \u003ccode\u003etype\u003c/code\u003e, \u003ccode\u003estate\u003c/code\u003e, \u003ccode\u003etrackingId\u003c/code\u003e, and other relevant fields depending on the task type.\u003c/p\u003e\n"]]],["This document details how to create a batch of `Task` objects via a `POST` HTTP request to `https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:batchCreate`. The `parent` path parameter is required and specifies the provider. The request body should contain a `header` and an array of `requests`, where each request includes a `CreateTaskRequest`. Each `CreateTaskRequest` requires a `parent`, `taskId`, and a `task` entity with specific fields. The response body returns an array of the created `Task` objects.\n"],null,[]]
