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)

اختياريّ. عنوان طلب واجهة برمجة التطبيقات Standard Delivery API ملاحظة: في حال إعداد هذا الحقل، يجب أن يكون حقل العنوان في رسائل CreateTaskRequest فارغًا أو يجب أن يتطابق مع هذا الحقل.

requests[]

object (CreateTaskRequest)

مطلوب. يشير ذلك المصطلح إلى رسالة الطلب التي تحدِّد الموارد المطلوب إنشاؤها. ملاحظة: يمكنك إنشاء 500 مهمة كحد أقصى في الدُفعة الواحدة.

نص الاستجابة

رسالة الردّ BatchCreateTask.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
الحقول
tasks[]

object (Task)

"مهام Google" التي تم إنشاؤها

CreateTaskRequest

رسالة طلب tasks.create.

تمثيل JSON
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
الحقول
header

object (DeliveryRequestHeader)

اختياريّ. عنوان طلب واجهة برمجة التطبيقات Standard Delivery API

parent

string

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

taskId

string

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

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

object (Task)

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

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

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