Method: projects.batchOptimizeTours

एक या इससे ज़्यादा OptimizeToursRequest मैसेज के लिए, वाहन के टूर को बैच के तौर पर ऑप्टिमाइज़ करता है.

यह तरीका, ज़्यादा समय तक चलने वाली कार्रवाई (एलआरओ) है. ऑप्टिमाइज़ेशन के लिए इनपुट (OptimizeToursRequest मैसेज) और आउटपुट (OptimizeToursResponse मैसेज), उपयोगकर्ता के तय किए गए फ़ॉर्मैट में Cloud Storage से पढ़े और लिखे जाते हैं. projects.optimizeTours तरीके की तरह, हर OptimizeToursRequest में एक ShipmentModel होता है. साथ ही, यह ShipmentRoute फ़ील्ड वाला OptimizeToursResponse दिखाता है. ये फ़ील्ड, वाहनों के लिए तय किए गए रूट का सेट होते हैं. इससे कुल लागत कम हो जाती है.

उपयोगकर्ता, एलआरओ की स्थिति देखने के लिए operations.get को पोल कर सकता है:

अगर LRO done फ़ील्ड की वैल्यू false है, तो इसका मतलब है कि कम से कम एक अनुरोध अब भी प्रोसेस किया जा रहा है. ऐसा हो सकता है कि अन्य अनुरोध पूरे हो गए हों और उनके नतीजे Cloud Storage में उपलब्ध हों.

अगर एलआरओ का done फ़ील्ड 'सही' पर सेट है, तो इसका मतलब है कि सभी अनुरोध प्रोसेस हो गए हैं. प्रोसेस किए गए सभी अनुरोधों के नतीजे, Cloud Storage में उपलब्ध होंगे. पूरे नहीं हो पाए अनुरोधों के नतीजे, Cloud Storage में उपलब्ध नहीं होंगे. अगर एलआरओ का error फ़ील्ड सेट है, तो इसमें उन अनुरोधों में से किसी एक की गड़बड़ी शामिल होती है जो पूरे नहीं हो सके.

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

POST https://routeoptimization.googleapis.com/v1/{parent=projects/*}:batchOptimizeTours

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. कॉल करने के लिए, टारगेट प्रोजेक्ट और जगह.

फ़ॉर्मैट:

  • projects/{project-id}
  • projects/{project-id}/locations/-

क्षेत्र के हिसाब से {location-id} वैल्यू इस्तेमाल नहीं की जा सकतीं.

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

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

JSON के काेड में दिखाना
{
  "modelConfigs": [
    {
      object (AsyncModelConfig)
    }
  ]
}
फ़ील्ड
modelConfigs[]

object (AsyncModelConfig)

ज़रूरी है. हर खरीदारी मॉडल के लिए इनपुट/आउटपुट की जानकारी, जैसे कि फ़ाइल पाथ और डेटा फ़ॉर्मैट.

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में Operation का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/cloud-platform

IAM से जुड़ी अनुमतियां

parent संसाधन पर, IAM की यह अनुमति ज़रूरी है:

  • routeoptimization.operations.create

ज़्यादा जानकारी के लिए, IAM दस्तावेज़ देखें.