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 حرفًا.
  • تم تسويتها وفقًا لنموذج تسويتها في يونيكود (C).
  • يجب ألّا تحتوي على أي من أحرف ASCII التالية: ‎/‎ أو ‎:‎ أو ‎?‎ أو ‎,‎ أو ‎#‎.
task

object (Task)

مطلوب. عنصر المهمة المطلوب إنشاؤه. عند إنشاء مهمة، تكون الحقول التالية مطلوبة:

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

يمكن ضبط الحقول التالية اختياريًا:

  • targetTimeWindow
  • taskTrackingViewConfig
  • attributes

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