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 Normalization Form C.
  • לא יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ' או '#'.
task

object (Task)

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

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

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