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)

اختياريّ. عنوان الطلب العادي لواجهة برمجة التطبيقات للتسليم العادي. ملاحظة: في حال إعداد هذا الحقل، يجب أن يكون حقل العنوان في رسائل 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)

اختياريّ. عنوان الطلب العادي لواجهة برمجة التطبيقات للتسليم العادي.
parent

string

مطلوبة. يجب استخدام التنسيق providers/{provider}. يجب أن يكون provider هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project
taskId

string

مطلوبة. يجب أن يكون معرّف المهمة فريدًا، ولكن يجب ألا يكون معرّف تتبُّع الشحن. لتخزين رقم تعريف تتبُّع الشحن، استخدِم الحقل trackingId. يُرجى العلم أنّه يمكن أن تتضمّن مهام متعددة سمة trackingId نفسها. تخضع معرفات المهام للقيود التالية:

  • يجب أن تكون سلسلة Unicode صالحة.
  • الحد الأقصى لعدد الأحرف هو 64 حرفًا.
  • تتم تسويتها وفقًا لنموذج تسوية Unicode.
  • لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
task

object (Task)

مطلوبة. تمثّل هذه السمة كيان المهمة المطلوب إنشاؤه. الحقول التالية مطلوبة عند إنشاء مهمة:

  • type
  • state (يجب الضبط على OPEN)
  • trackingId (يجب عدم الإعداد لمهام UNAVAILABLE أو SCHEDULED_STOP، ولكنه مطلوب لكل أنواع المهام الأخرى)
  • plannedLocation (اختياري لـ UNAVAILABLE مهمة)
  • taskDuration

ملاحظة: يتم تجاهل الحقل name للمهمة. يجب عدم ضبط جميع حقول "المهام" الأخرى، وإلا سيتم عرض خطأ.