Method: providers.tasks.batchCreate

Crée et renvoie un lot de nouveaux 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 correspondre à l'ID du projet Google Cloud. Exemple : sample-cloud-project. Le champ parent dans les 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 pouvez créer un maximum de 500 tâches par lot.

Corps de la réponse

Le 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)

Tâches créées.

CreateTaskRequest

Le 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 correspondre à l'ID du projet Google Cloud. Exemple : sample-cloud-project.
taskId

string

Obligatoire. L'ID de la tâche doit être unique, mais il ne doit pas s'agir d'un ID de suivi du colis. Pour stocker un ID de suivi de livraison, 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:

  • Veuillez saisir une chaîne Unicode valide.
  • Ne doit pas dépasser 64 caractères.
  • Normalisée selon le formulaire C de normalisation Unicode.
  • Ne doit pas contenir les caractères ASCII suivants : "/", ":", "?", "," ou "#".
task

object (Task)

Obligatoire. Entité Task à créer. Lors de la création d'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 UNAVAILABLE tâches)
  • taskDuration

Remarque: Le champ name de la tâche est ignoré. Aucun autre champ de tâche ne doit être défini. sinon une erreur est renvoyée.