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)

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

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