Method: providers.vehicles.get

הפונקציה מחזירה רכב מ-Fleet Engine.

בקשת HTTP

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

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

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

פרמטרים
name

string

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

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

פרמטרים
header

object (RequestHeader)

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

string (Timestamp format)

מציין את חותמת הזמן המינימלית (לא כולל) שלגביה מתבצע אחזור של Vehicle.current_route_segment. אם המסלול לא השתנה מאז חותמת הזמן הזו, השדה currentRouteSegment לא מוגדר בתגובה. אם לא מצוין ערך מינימלי, הערך של currentRouteSegment מאוחזר תמיד.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
waypointsVersion

string (Timestamp format)

מציין את חותמת הזמן המינימלית (לא כולל) שלגביה מתבצע אחזור של נתוני Vehicle.waypoints. אם נקודות הדרך לא השתנו מאז חותמת הזמן הזו, נתוני vehicle.waypoints לא מוגדרים בתגובה. אם לא מציינים את השדה הזה, תמיד מתבצע אחזור של vehicle.waypoints.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

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