Method: providers.tasks.batchCreate

नए Task ऑब्जेक्ट का एक बैच बनाता है और उसे दिखाता है.

एचटीटीपी अनुरोध

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

यूआरएल में 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 हो सकता है. टास्क आईडी पर ये पाबंदियां लागू होती हैं:

  • यह एक मान्य यूनिकोड स्ट्रिंग होनी चाहिए.
  • इसमें 64 से ज़्यादा वर्ण इस्तेमाल नहीं किए जा सकते.
  • यूनिकोड नॉर्मलाइज़ेशन फ़ॉर्म C के हिसाब से नॉर्मलाइज़ किया गया.
  • इसमें इनमें से कोई भी ASCII वर्ण नहीं होना चाहिए: '/', ':', '?', ',' या '#'.
task

object (Task)

ज़रूरी है. टास्क इकाई बनाने के लिए. टास्क बनाते समय, इन फ़ील्ड में जानकारी डालना ज़रूरी है:

  • type
  • state (OPEN पर सेट होना चाहिए)
  • trackingId (UNAVAILABLE या SCHEDULED_STOP टास्क के लिए सेट नहीं किया जाना चाहिए, लेकिन अन्य सभी तरह के टास्क के लिए ज़रूरी है)
  • plannedLocation (UNAVAILABLE टास्क के लिए ज़रूरी नहीं)
  • taskDuration

ध्यान दें: टास्क के name फ़ील्ड को अनदेखा किया जाता है. टास्क के अन्य सभी फ़ील्ड सेट नहीं होने चाहिए. ऐसा करने पर, गड़बड़ी का मैसेज दिखता है.