Method: providers.tasks.batchCreate

Crée et affiche un lot d'objets Task.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Ressource parente partagée par toutes les tâches. Cette valeur doit être au format providers/{provider}. provider doit être l'ID du projet Google Cloud. Par exemple, sample-cloud-project. Le champ parent des messages CreateTaskRequest doit être vide ou correspondre à ce champ.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
Champs
header

object (DeliveryRequestHeader)

Facultatif. En-tête de requête standard de l'API Delivery. Remarque: Si vous définissez ce champ, le champ d'en-tête des messages CreateTaskRequest doit être vide ou correspondre à ce champ.
requests[]

object (CreateTaskRequest)

Obligatoire. Message de requête spécifiant les ressources à créer. Remarque: Vous ne pouvez créer qu'un maximum de 500 tâches par lot.

Corps de la réponse

Message de réponse BatchCreateTask.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
Champs
tasks[]

object (Task)

Les tâches créées.

CreateTaskRequest

Message de requête tasks.create.

Représentation JSON 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
Champs
header

object (DeliveryRequestHeader)

Facultatif. En-tête de requête standard de l'API Delivery.
parent

string

Obligatoire. Doit se présenter sous la forme providers/{provider}. provider doit être l'ID du projet Google Cloud. Par exemple, sample-cloud-project.
taskId

string

Obligatoire. L'ID de tâche doit être unique, mais ne doit pas correspondre à un numéro de suivi d'envoi. Pour stocker un ID de suivi d'envoi, utilisez le champ trackingId. Notez que plusieurs tâches peuvent avoir le même trackingId. Les ID de tâche sont soumis aux restrictions suivantes:

  • Doit être une chaîne Unicode valide.
  • Limité à 64 caractères maximum.
  • Normalisé selon la forme de normalisation C Unicode.
  • Ne doit pas contenir l'un des caractères ASCII suivants: '/', ':', '?', ',' ou '#'.
task

object (Task)

Obligatoire. Entité Task à créer. Lorsque vous créez une tâche, les champs suivants sont obligatoires:

  • type
  • state (doit être défini sur OPEN)
  • trackingId (ne doit pas être défini pour les tâches UNAVAILABLE ou SCHEDULED_STOP, mais est obligatoire pour tous les autres types de tâches)
  • plannedLocation (facultatif pour les tâches UNAVAILABLE)
  • taskDuration

Vous pouvez éventuellement définir les champs suivants:

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

Remarque: Le champ name de la tâche est ignoré. Tous les autres champs de la tâche ne doivent pas être définis. Sinon, une erreur est renvoyée.