Method: providers.tasks.batchCreate

دسته ای از اشیاء Task جدید را ایجاد و برمی گرداند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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 داشته باشند. شناسه های وظیفه مشمول محدودیت های زیر هستند:

  • باید یک رشته یونیکد معتبر باشد.
  • حداکثر به طول 64 کاراکتر محدود شده است.
  • طبق فرم C عادی سازی یونیکد نرمال شده است.
  • ممکن است حاوی هیچ یک از کاراکترهای ASCII زیر نباشد: «/»، «:»، «؟»، «،»، یا «#».
task

object ( Task )

مورد نیاز. موجودیت وظیفه برای ایجاد. هنگام ایجاد یک Task، فیلدهای زیر مورد نیاز است:

  • type
  • state (باید روی OPEN تنظیم شود)
  • trackingId (نباید برای کارهای UNAVAILABLE یا SCHEDULED_STOP تنظیم شود، اما برای همه انواع وظایف دیگر لازم است)
  • plannedLocation (اختیاری برای کارهای UNAVAILABLE )
  • taskDuration

توجه: قسمت name Task نادیده گرفته می شود. تمام فیلدهای وظیفه دیگر نباید تنظیم شوند. در غیر این صورت، یک خطا برگردانده می شود.