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 و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

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

يتطلّب ذلك إذن إدارة الهوية وإمكانية الوصول التالي في المورد 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 وdynamicRouting وdynamicRoute فقط (بما في ذلك origin وdestination وintermediates).

مثال: "displayName,routeAttributes,dynamicRouting,dynamicRoute"

في حال تحديد *، يتم استبدال جميع الحقول القابلة للتعديل بالكامل.

في حال حذف updateMask، سيتم تعديل جميع الحقول القابلة للتعديل التي تمت تعبئتها في selectedRoute.