Method: providers.tasks.batchCreate

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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 תווים.
  • מנורמלים בהתאם לפורמט נירמול C של Unicode.
  • אסור לכלול את תווים ה-ASCII הבאים: '/',‏ ':',‏ '?',‏ ',' או '#'.
task

object (Task)

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

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

אפשר להגדיר את השדות הבאים:

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

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