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)

אפשרות. כותרת הבקשה הרגילה של ה-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)

אפשרות. כותרת הבקשה הרגילה של ה-API למסירה.
parent

string

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

string

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

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

object (Task)

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

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

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