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