- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- आईएएम की अनुमतियां
बैच के तौर पर एक या उससे ज़्यादा OptimizeToursRequest मैसेज के लिए, वाहन के टूर को ऑप्टिमाइज़ करता है.
यह तरीका, ज़्यादा समय तक चलने वाला ऑपरेशन (एलआरओ) है. ऑप्टिमाइज़ेशन (OptimizeToursRequest मैसेज) और आउटपुट (OptimizeToursResponse मैसेज) के इनपुट, उपयोगकर्ता के तय किए गए फ़ॉर्मैट में Cloud Storage से पढ़े/लिखे जाते हैं. locations.optimizeTours वाले तरीके की तरह, हर OptimizeToursRequest में एक ShipmentModel होता है और ShipmentRoute वाले OptimizeToursResponse की जानकारी देता है. इन रास्तों का सेट ऐसे रास्तों का होता है जिन पर जाने वाले वाहनों की मदद से, कुल लागत को कम से कम किया जाता है.
उपयोगकर्ता, एलआरओ का स्टेटस देखने के लिए operations.get को पोल कर सकता है:
अगर एलआरओ का done फ़ील्ड गलत है, तो इसका मतलब है कि कम से कम एक अनुरोध अब भी प्रोसेस किया जा रहा है. हो सकता है कि अन्य अनुरोध पूरे हो गए हों और उनके नतीजे GCS में उपलब्ध हों.
अगर एलआरओ का done फ़ील्ड 'सही' है, तो इसका मतलब है कि सभी अनुरोध प्रोसेस हो गए हैं. प्रोसेस हो चुके सभी अनुरोध के नतीजे GCS (जीसीएस) में उपलब्ध होंगे. जो अनुरोध पूरे नहीं हो पाते उनके नतीजे GCS (जीसीएस) में उपलब्ध नहीं होंगे. अगर एलआरओ का error फ़ील्ड सेट है, तो इसमें उस अनुरोध से जुड़ी गड़बड़ी की जानकारी होती है जो पूरा नहीं हो सका.
एचटीटीपी अनुरोध
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:batchOptimizeTours
यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.
पाथ पैरामीटर
| पैरामीटर | |
|---|---|
parent |
ज़रूरी है. कॉल करने के लिए, प्रोजेक्ट और जगह को टारगेट करें. फ़ॉर्मैट: * अगर कोई जगह नहीं बताई जाती है, तो कोई क्षेत्र अपने-आप चुना जाएगा. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
| JSON के काेड में दिखाना |
|---|
{
"modelConfigs": [
{
object ( |
| फ़ील्ड | |
|---|---|
modelConfigs[] |
ज़रूरी है. हर खरीदारी मॉडल की जानकारी इनपुट/आउटपुट जानकारी, जैसे कि फ़ाइल पाथ और डेटा फ़ॉर्मैट. |
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Operation का एक इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/cloud-platform
IAM की अनुमतियां
parent संसाधन पर, IAM की इस अनुमति की ज़रूरत है:
routeoptimization.operations.create
ज़्यादा जानकारी के लिए, IAM दस्तावेज़ देखें.