रूट ऑप्टिमाइज़ेशन एपीआई दो तरीकों से जानकारी देता है:
OptimizeToursएक सिंक्रोनस तरीका है, जोOptimizeToursRequestके लिए जवाब दिया गया है. क्लाइंट को अपनी वेबसाइट का रूट ऑप्टिमाइज़ेशन एपीआई से कनेक्ट करके रखने की अनुमति देते हैं. ऐसा तब तक होता रहेगा, जब तक अनुरोध प्रोसेस नहीं होता और एकOptimizeToursResponseया गड़बड़ी मिलती है.BatchOptimizeToursएक एसिंक्रोनस तरीका है, जो किसी एक के लिए यूआरआई स्वीकार करता है या ज़्यादाOptimizeToursRequestऔर संबंधितOptimizeToursResponseमैसेज दिखाता है, जो लॉन्ग रनिंग ऑपरेशन (एलआरओ) के संसाधन का नाम दिखाता है (REST, gRPC) जिसका इस्तेमाल बैच पूरा होने की जांच करने के लिए किया जाता है.OptimizeToursRequestको बैकग्राउंड में प्रोसेस किया जाता है. इसलिए, क्लाइंट इन प्रोसेस को बनाए रखते हैं रूट ऑप्टिमाइज़ेशन एपीआई के लिए एक खुला कनेक्शन जो सिर्फ़ सबमिट करने के लिए काफ़ी लंबा हो LRO देखने के लिए,BatchOptimizeToursRequestयाGetOperationको कॉल करें स्थिति.BatchOptimizeToursउनके अनुरोधों को पढ़ता है और उनके जवाब लिखता है Google Cloud Storage.
उपयोग के उदाहरण
OptimizeTours छोटे और आसानी से किए जाने वाले अनुरोधों को हल करने के लिए या
कुछ मिनट या इससे कम समय में हल करने के लिए मिले अनुरोध. लंबे समय तक लाइव स्ट्रीम बनाए रखना
रूट ऑप्टिमाइज़ेशन एपीआई से कनेक्ट करने से, Google Search Ads 360 के पुराने और
तो उन्हें हल किया जा सकता है.
BatchOptimizeTours की मदद से, बड़े अनुरोधों और अनुरोधों को हैंडल करके, ज़्यादा समय तक समाधान किया जा सकता है
समय है क्योंकि इसे रूट के लिए लंबे समय तक चलने वाले कनेक्शन की आवश्यकता नहीं होती
ऑप्टिमाइज़ेशन एपीआई.
लंबे समय तक चलने वाली कार्रवाइयां
एलआरओ को रूट ऑप्टिमाइज़ेशन एपीआई से पढ़ने के लिए, GetOperation तरीके का इस्तेमाल किया जाता है
बैच के पूरा होने की स्थिति चेक करें. एलआरओ में ऐसी done प्रॉपर्टी शामिल होती है जो
यह बताता है कि पूरे बैच की प्रोसेसिंग पूरी हो गई है और error
प्रोसेसिंग के दौरान हुई गड़बड़ियों की रिपोर्ट करती है. अगर done सही है और
कोई error मौजूद नहीं है, बैच सफलतापूर्वक पूरा हुआ. किसी चीज़ की मौजूदगी
error से पता चलता है कि कुछ या सभी बैच प्रोसेस नहीं किए जा सके.
आम तौर पर, BatchOptimizeTours अनुरोध की लाइफ़साइकल कुछ इस तरह होती है:
- रूट ऑप्टिमाइज़ेशन एपीआई के लिए
BatchOptimizeToursRequestसबमिट करें, जो किसी LRO के संसाधन का नाम दिखाता है. - एलआरओ रिसॉर्स के नाम के साथ
GetOperationपोल तब तक बनाएं, जब तक किdoneया एलआरओ के जवाब मेंerrorप्रॉपर्टी दिखती हैं. - अगर
doneसही है और कोई गड़बड़ी मौजूद नहीं है, तोOptimizeToursResponsesपढ़ें Google Cloud Storage केBatchOptimizeToursमें तय किए गए यूआरआई से अनुरोध. अगरerrorमौजूद है, तो गड़बड़ी की जांच करें और Google Cloud Storage में जाकरOptimizeToursRequestचुकाएं. इसके बाद, फिर से कोशिश करें दिखाई गई गड़बड़ी पर निर्भर करेगा.
आपके पास कई तरह की सेटिंग में OptimizeTours और BatchOptimizeTours अनुरोध भेजने की सुविधा है
कमांड लाइन से या क्लाइंट लाइब्रेरी से.