Method: projects.optimizeToursUri

यह projects.optimizeToursLongRunning तरीके का एक वैरिएंट है. इसे ज़्यादा टाइम आउट वैल्यू और बड़े इनपुट/आउटपुट साइज़ के साथ ऑप्टिमाइज़ेशन के लिए डिज़ाइन किया गया है.

क्लाइंट, Google Cloud Storage में सेव किए गए OptimizeToursRequest का यूआरआई बताता है. इसके बाद, सर्वर क्लाइंट के बताए गए Google Cloud Storage यूआरआई में OptimizeToursResponse को सेव करता है.

यह तरीका, projects.optimizeTours तरीके से बेहतर है. इसका इस्तेमाल उन ऑप्टिमाइज़ेशन के लिए किया जाना चाहिए जिनमें कुछ मिनट से ज़्यादा समय लगता है और इनपुट/आउटपुट का साइज़ 8 एमबी से ज़्यादा होता है. हालांकि, इसका इस्तेमाल छोटे ऑप्टिमाइज़ेशन के लिए भी किया जा सकता है.

नतीजे के तौर पर मिले long-running operation (एलआरओ) का नाम <parent>/operations/<operation_id> फ़ॉर्मैट में होगा. इसका इस्तेमाल, कंप्यूटेशन की प्रोग्रेस को ट्रैक करने के लिए किया जा सकता है. metadata फ़ील्ड का टाइप OptimizeToursUriMetadata है. अगर फ़ील्ड सही तरीके से अपडेट हो जाता है, तो response फ़ील्ड का टाइप OptimizeToursUriResponse हो जाता है.

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

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

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

पाथ पैरामीटर

पैरामीटर
parent

string

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

फ़ॉर्मैट:

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

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

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

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

JSON के काेड में दिखाना 
{
  "input": {
    object (Uri)
  },
  "output": {
    object (Uri)
  }
}
फ़ील्ड
input

object (Uri)

ज़रूरी है. Cloud Storage ऑब्जेक्ट का यूआरआई, जिसमें OptimizeToursRequest शामिल है.
output

object (Uri)

ज़रूरी है. Cloud Storage ऑब्जेक्ट का यूआरआई, जिसमें OptimizeToursResponse शामिल होगा.

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

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

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

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

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

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

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

  • routeoptimization.operations.create

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