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

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