Method: providers.tasks.batchCreate

নতুন Task অবজেক্টের একটি ব্যাচ তৈরি করে এবং ফেরত দেয়।

HTTP অনুরোধ

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

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
parent

string

প্রয়োজন। সমস্ত কাজের দ্বারা ভাগ করা মূল সম্পদ। এই মানটি অবশ্যই providers/{provider} ফর্ম্যাটে হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project । CreateTaskRequest বার্তাগুলির মূল ক্ষেত্রটি অবশ্যই খালি থাকতে হবে, অথবা এটি অবশ্যই এই ক্ষেত্রের সাথে মিলবে৷

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
ক্ষেত্র
header

object ( DeliveryRequestHeader )

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম। দ্রষ্টব্য: আপনি যদি এই ক্ষেত্রটি সেট করেন, তাহলে CreateTaskRequest বার্তাগুলির শিরোনাম ক্ষেত্রটি হয় খালি থাকতে হবে, অথবা এটি অবশ্যই এই ক্ষেত্রের সাথে মিলবে।

requests[]

object ( CreateTaskRequest )

প্রয়োজন। অনুরোধ বার্তা যা তৈরি করার জন্য সংস্থানগুলি নির্দিষ্ট করে৷ দ্রষ্টব্য: আপনি একটি ব্যাচে সর্বাধিক 500টি কাজ তৈরি করতে পারেন।

প্রতিক্রিয়া শরীর

BatchCreateTask প্রতিক্রিয়া বার্তা।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
ক্ষেত্র
tasks[]

object ( Task )

তৈরি করা টাস্ক.

TaskRequest তৈরি করুন

tasks.create অনুরোধ বার্তা।

JSON প্রতিনিধিত্ব
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
ক্ষেত্র
header

object ( DeliveryRequestHeader )

ঐচ্ছিক। স্ট্যান্ডার্ড ডেলিভারি API অনুরোধ শিরোনাম।

parent

string

প্রয়োজন। ফর্ম্যাট providers/{provider} হতে হবে। provider অবশ্যই Google ক্লাউড প্রকল্প আইডি হতে হবে। উদাহরণস্বরূপ, sample-cloud-project ।

taskId

string

প্রয়োজন। টাস্ক আইডিটি অবশ্যই অনন্য হতে হবে, তবে এটি একটি শিপমেন্ট ট্র্যাকিং আইডি হওয়া উচিত নয়৷ একটি চালান ট্র্যাকিং আইডি সংরক্ষণ করতে, trackingId ক্ষেত্রটি ব্যবহার করুন৷ মনে রাখবেন যে একাধিক কাজের একই trackingId থাকতে পারে। টাস্ক আইডি নিম্নলিখিত বিধিনিষেধ সাপেক্ষে:

  • একটি বৈধ ইউনিকোড স্ট্রিং হতে হবে।
  • সর্বাধিক 64 অক্ষরের দৈর্ঘ্যে সীমাবদ্ধ।
  • ইউনিকোড নরমালাইজেশন ফর্ম সি অনুযায়ী স্বাভাবিক করা হয়েছে।
  • নিম্নলিখিত ASCII অক্ষরগুলির মধ্যে কোনও নাও থাকতে পারে: '/', ':', '?', ',', বা '#'৷
task

object ( Task )

প্রয়োজন। তৈরি করার টাস্ক সত্তা। একটি টাস্ক তৈরি করার সময়, নিম্নলিখিত ক্ষেত্রগুলি প্রয়োজন:

  • type
  • state ( OPEN সেট করা আবশ্যক)
  • trackingId ( UNAVAILABLE বা SCHEDULED_STOP কাজের জন্য সেট করা উচিত নয়, তবে অন্যান্য সমস্ত ধরনের কাজের জন্য প্রয়োজন)
  • plannedLocation ( UNAVAILABLE কাজের জন্য ঐচ্ছিক)
  • taskDuration

দ্রষ্টব্য: টাস্কের name ক্ষেত্রটি উপেক্ষা করা হয়েছে। অন্য সব টাস্ক ফিল্ড সেট করা উচিত নয়; অন্যথায়, একটি ত্রুটি ফেরত দেওয়া হয়।