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

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

يتطلّب الإذن التالي في إدارة الهوية وإمكانية الوصول (IAM) على مورد 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.