Method: providers.tasks.batchCreate

יצירה והחזרה של קבוצת אובייקטים חדשים מסוג Task.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. משאב ההורה שמשותף לכל המשימות. הפורמט של הערך הזה חייב להיות providers/{provider}. השדה provider חייב להיות מזהה הפרויקט ב-Google Cloud. לדוגמה, sample-cloud-project. שדה ההורה בהודעות CreateTaskRequest חייב להיות ריק או להתאים לשדה הזה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
שדות
header

object (DeliveryRequestHeader)

זה שינוי אופציונלי. כותרת הבקשה הרגילה של Delivery API. הערה: אם מגדירים את השדה הזה, שדה הכותרת בהודעות CreateTaskRequest חייב להיות ריק או להתאים לשדה הזה.

requests[]

object (CreateTaskRequest)

חובה. הודעת הבקשה שמציינת את המשאבים שיש ליצור. הערה: אפשר ליצור עד 500 משימות בבת אחת.

גוף התשובה

הודעת התשובה BatchCreateTask.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
שדות
tasks[]

object (Task)

המשימות שנוצרו.

CreateTaskRequest

הודעת הבקשה של tasks.create.

ייצוג JSON
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
שדות
header

object (DeliveryRequestHeader)

זה שינוי אופציונלי. כותרת הבקשה הרגילה של Delivery API.

parent

string

חובה. חייב להיות בפורמט providers/{provider}. השדה provider חייב להיות מזהה הפרויקט ב-Google Cloud. לדוגמה, sample-cloud-project.

taskId

string

חובה. מזהה המשימה חייב להיות ייחודי, אבל לא מזהה לצורכי מעקב אחר משלוח. כדי לשמור מזהה לצורכי מעקב, צריך להשתמש בשדה trackingId. הערה: לכמה משימות יכול להיות אותו trackingId. מזהי המשימות כפופים להגבלות הבאות:

  • חייבת להיות מחרוזת Unicode חוקית.
  • מוגבלת לאורך של 64 תווים לכל היותר.
  • מנורמלים בהתאם לטופס הנירמול של Unicode C.
  • לא יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ' או '#'.
task

object (Task)

חובה. ישות המשימה שצריך ליצור. כשיוצרים משימה, חובה למלא את השדות הבאים:

  • type
  • state (חייב להיות מוגדר ל-OPEN)
  • trackingId (לא יכול להיות מוגדר ל-UNAVAILABLE או ל-SCHEDULED_STOP משימות, אבל נדרש לכל סוגי המשימות האחרים)
  • plannedLocation (אופציונלי ל-UNAVAILABLE משימות)
  • taskDuration

הערה: המערכת מתעלמת מהשדה name של המשימה. אין להגדיר את כל שאר השדות של המשימה; אחרת, תוחזר שגיאה.