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 मैसेज का पैरंट फ़ील्ड या तो खाली होना चाहिए या उसे इस फ़ील्ड से मेल खाना चाहिए.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "requests": [
    {
      object (CreateTaskRequest)
    }
  ]
}
फ़ील्ड
header

object (DeliveryRequestHeader)

ज़रूरी नहीं. डिलीवरी एपीआई अनुरोध का स्टैंडर्ड हेडर. ध्यान दें: इस फ़ील्ड को सेट करने पर, CreateTaskRequest मैसेज में हेडर फ़ील्ड खाली होना चाहिए या उसे इस फ़ील्ड से मेल खाना चाहिए.
requests[]

object (CreateTaskRequest)

ज़रूरी है. अनुरोध वाला वह मैसेज होता है जिसमें बनाए जाने वाले संसाधनों के बारे में बताया जाता है. ध्यान दें: एक बैच में ज़्यादा से ज़्यादा 500 टास्क बनाए जा सकते हैं.

जवाब का मुख्य भाग

BatchCreateTask रिस्पॉन्स मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "tasks": [
    {
      object (Task)
    }
  ]
}
फ़ील्ड
tasks[]

object (Task)

बनाए गए टास्क.

CreateTaskRequest

tasks.create अनुरोध का मैसेज.

जेएसओएन के काेड में दिखाना 
{
  "header": {
    object (DeliveryRequestHeader)
  },
  "parent": string,
  "taskId": string,
  "task": {
    object (Task)
  }
}
फ़ील्ड
header

object (DeliveryRequestHeader)

ज़रूरी नहीं. डिलीवरी एपीआई अनुरोध का स्टैंडर्ड हेडर.
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 फ़ील्ड नज़रअंदाज़ कर दिया जाता है. बाकी सभी टास्क फ़ील्ड सेट नहीं होने चाहिए. ऐसा न होने पर, गड़बड़ी दिखती है.