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.