Method: selection.v1.projects.selectedRoutes.batchUpdate

עדכון של כמה משאבי SelectedRoute לפי השמות שלהם.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של הנתיב

פרמטרים
parent

string

חובה. משאב הפרויקט שמשותף לכל המסלולים שנבחרו באצווה. הוא נדרש כי בקשת ה-Batch תומכת רק ב-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

נדרשת הרשאת IAM הבאה במשאב parent:

  • 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 נחשבים כמעודכנים.