Method: providers.vehicles.update

כתיבת נתונים מעודכנים של רכב ב-Fleet Engine.

כשמעדכנים Vehicle, אי אפשר לעדכן את השדות הבאים כי הם מנוהלים על ידי השרת:

  • currentTrips
  • availableCapacity
  • currentRouteSegmentVersion
  • waypointsVersion

כמו כן, לא ניתן לעדכן את הרכב name.

אם מעדכנים את השדה attributes, כל מאפייני הרכב מוחלפים במאפיינים שצוינו בבקשה. אם רוצים לעדכן רק חלק מהמאפיינים, אפשר לעיין בשיטה vehicles.updateAttributes. בדומה לכך, אפשר לעדכן את השדה waypoints, אבל עליו לכלול את כל ציוני הדרך שנמצאים כרגע ברכב, ולא ציוני דרך אחרים.

בקשת HTTP

PUT https://fleetengine.googleapis.com/v1/{name=providers/*/vehicles/*}

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
name

string

חובה. חייב להיות בפורמט providers/{provider}/vehicles/{vehicle}. הספק {provider} חייב להיות מזהה הפרויקט (לדוגמה, sample-cloud-project) של הפרויקט ב-Google Cloud שחשבון השירות שמבצע את השיחה הזו משויך אליו.

פרמטרים של שאילתה

פרמטרים
header

object (RequestHeader)

כותרת הבקשה הרגילה של Fleet Engine.
updateMask

string (FieldMask format)

חובה. מסיכת שדות שמציינת אילו שדות ב-Vehicle צריך לעדכן. יש לספק שם שדה אחד לפחות.

זוהי רשימה מופרדת בפסיקים של שמות שדות מלאים. דוגמה: "user.displayName,photo"

גוף הבקשה

גוף הבקשה מכיל מופע של Vehicle.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Vehicle.