Method: selection.v1.projects.selectedRoutes.batchUpdate

يعدِّل هذا الطلب عدة موارد SelectedRoute كما هو محدّد بأسمائها.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى 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

أذونات "إدارة الهوية وإمكانية الوصول"

يجب توفير إذن إدارة الهوية وإمكانية الوصول التالي على مورد parent

  • roads.selectedRoutes.batchUpdate

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات "إدارة الهوية وإمكانية الوصول".

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.