Method: projects.optimizeToursUri

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

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

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

लौटाए गए 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)

ज़रूरी है. OptimizeToursRequest वाला Cloud Storage ऑब्जेक्ट का यूआरआई.
output

object (Uri)

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

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

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

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

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

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

IAM अनुमतियां

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

  • routeoptimization.operations.create

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