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, और dynamicRoute (इसमें origin, destination, और intermediates शामिल हैं) को अपडेट करना चाहिए.

उदाहरण: "displayName,routeAttributes,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 या dynamicRoute (इसमें origin, destination, और intermediates शामिल हैं) को अपडेट करना चाहिए.

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

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

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