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

נדרשת הרשאת 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 וdynamicRoute (כולל origin,‏ destination וintermediates).

דוגמה: "displayName,routeAttributes,dynamicRoute"

אם מציינים את *, מתבצעת החלפה מלאה של כל השדות שניתנים לעדכון.

אם לא מציינים את updateMask, כל השדות שאפשר לעדכן שאוכלסו ב-selectedRoute יעדכנו.