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 être l'ID du projet Google Cloud. 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 de l'API Delivery standard. 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 qui spécifie les ressources à créer. Remarque: Vous pouvez créer jusqu'à 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

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 de l'API Delivery standard.
parent

string

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

string

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

  • Vous devez saisir une chaîne Unicode valide.
  • 64 caractères maximum.
  • Normalisée conformément au formulaire de normalisation Unicode C.
  • Ne doit pas contenir les caractères ASCII suivants: "/", ":", "?", "#".
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 obligatoire pour tous les autres types de tâches)
  • plannedLocation (facultatif pour les tâches UNAVAILABLE)
  • taskDuration

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