Method: selection.v1.projects.selectedRoutes.batchUpdate

नामों के हिसाब से, एक से ज़्यादा SelectedRoute संसाधनों को अपडेट करता है.

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

POST https://roads.googleapis.com/selection/v1/{parent=projects/*}/selectedRoutes:batchUpdate

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. बैच में चुने गए सभी रूट के लिए शेयर किया गया प्रोजेक्ट रिसॉर्स. ऐसा करना इसलिए ज़रूरी है, क्योंकि बैच अनुरोध में सिर्फ़ एक parent का इस्तेमाल किया जा सकता है. फ़ॉर्मैट: projects/{project}

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

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

JSON के काेड में दिखाना 
{
  "requests": [
    {
      object (UpdateSelectedRouteRequest)
    }
  ],
  "updateMask": string
}
फ़ील्ड
requests[]

object (UpdateSelectedRouteRequest)

ज़रूरी है. अनुरोध का मैसेज, जिसमें अपडेट करने के लिए चुने गए रास्ते की जानकारी दी गई हो. एक बैच में, चुने गए ज़्यादा से ज़्यादा 1,000 रूट अपडेट किए जा सकते हैं. हर अनुरोध का पैरंट रिसॉर्स या तो खाली होना चाहिए या टॉप-लेवल parent से मेल खाना चाहिए.
updateMask

string (FieldMask format)

ज़रूरी नहीं. बैच में मौजूद सभी चाइल्ड अनुरोधों के ज़रिए शेयर किए गए, अपडेट किए जाने वाले फ़ील्ड की सूची.

फ़ील्ड पाथ, SelectedRoute से मिलते-जुलते हैं. आपको सिर्फ़ displayName, routeAttributes, dynamicRouting, और dynamicRoute को अपडेट करना चाहिए. इनमें origin, destination, और intermediates भी शामिल हैं.

उदाहरण: "displayName,routeAttributes,dynamicRouting,dynamicRoute".

अगर यह सेट है, तो यह updateMask उन सभी चाइल्ड अनुरोधों पर लागू होता है जो अपने updateMask के बारे में नहीं बताते. अगर * की वैल्यू दी गई है, तो अपडेट किए जा सकने वाले सभी फ़ील्ड को पूरी तरह से बदल दिया जाता है. अगर बैच और चाइल्ड रिक्वेस्ट लेवल, दोनों के updateMask फ़ील्ड सेट हैं, तो वे मैच होने चाहिए.

अगर इसे शामिल नहीं किया जाता है, तो चाइल्ड रिक्वेस्ट का updateMask लागू होगा. अगर चाइल्ड रिक्वेस्ट के updateMask को भी शामिल नहीं किया जाता है, तो चाइल्ड रिक्वेस्ट के selectedRoute में मौजूद सभी अपडेट किए जा सकने वाले फ़ील्ड अपडेट हो जाते हैं.

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

एक से ज़्यादा SelectedRoute अपडेट करने से मिला जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "selectedRoutes": [
    {
      object (SelectedRoute)
    }
  ]
}
फ़ील्ड
selectedRoutes[]

object (SelectedRoute)

SelectedRoute संसाधन अपडेट किया गया.

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

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

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

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

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

  • roads.selectedRoutes.batchUpdate

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

UpdateSelectedRouteRequest

SelectedRoute को अपडेट करने का अनुरोध.

JSON के काेड में दिखाना 
{
  "selectedRoute": {
    object (SelectedRoute)
  },
  "updateMask": string
}
फ़ील्ड
selectedRoute

object (SelectedRoute)

ज़रूरी है. SelectedRoute को अपडेट करना है. रूट के name फ़ील्ड का इस्तेमाल, अपडेट किए जाने वाले रूट की पहचान करने के लिए किया जाता है. फ़ॉर्मैट: projects/{project}/selectedRoutes/{selectedRoute}
updateMask

string (FieldMask format)

ज़रूरी नहीं. अपडेट किए जाने वाले फ़ील्ड की सूची.

फ़ील्ड पाथ, SelectedRoute से मिलते-जुलते हैं. आपको सिर्फ़ displayName, routeAttributes, dynamicRouting, और dynamicRoute को अपडेट करना चाहिए. इनमें origin, destination, और intermediates भी शामिल हैं.

उदाहरण: "displayName,routeAttributes,dynamicRouting,dynamicRoute".

अगर * की वैल्यू दी गई है, तो अपडेट किए जा सकने वाले सभी फ़ील्ड को पूरी तरह से बदल दिया जाता है.

अगर updateMask को शामिल नहीं किया जाता है, तो selectedRoute में मौजूद अपडेट किए जा सकने वाले सभी फ़ील्ड अपडेट हो जाएंगे.