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.