אופטימיזציה של סיורים לכלי רכב עבור הודעה אחת או יותר מסוג OptimizeToursRequest כקבוצה.
השיטה הזו היא פעולה ממושכת (LRO). הקלט לאופטימיזציה (OptimizeToursRequest הודעות) והפלטים (OptimizeToursResponse הודעות) נקרא/נכתב מ-Cloud Storage או אל Cloud Storage בפורמט שהוגדר על ידי המשתמש. כמו השיטה locations.optimizeTours, כל ערך של OptimizeToursRequest מכיל ShipmentModel ומחזיר ערך של OptimizeToursResponse שמכיל ShipmentRoute – קבוצת מסלולים שכלי רכב מפחיתים מהעלות הכוללת.
המשתמש יכול לבצע דגימה של operations.get כדי לבדוק את הסטטוס של ה-LRO:
אם השדה done של ה-LRO הוא false, סימן שעדיין מתבצע עיבוד של בקשה אחת לפחות. יכול להיות שבקשות אחרות הושלמו בהצלחה והתוצאות שלהן זמינות ב-GCS.
אם השדה done של ה-LRO הוא true, כל הבקשות עובדו. התוצאות של בקשות שתעובדו בהצלחה יהיו זמינות ב-GCS. התוצאות של בקשות שנכשלו לא יהיו זמינות ב-GCS. אם השדה error ב-LRO מוגדר, הוא מכיל את השגיאה מאחת מהבקשות שנכשלו.
בקשת HTTP
POST https://routeoptimization.googleapis.com/v1/{parent=projects/*/locations/*}:batchOptimizeTours
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
parent |
חובה. צריך לטרגט את הפרויקט והמיקום כדי לבצע שיחה. פורמט: * אם לא מציינים מיקום, המערכת בוחרת אזור באופן אוטומטי. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
|---|
{
"modelConfigs": [
{
object ( |
| שדות | |
|---|---|
modelConfigs[] |
חובה. פרטי קלט/פלט של כל מודל רכישה, כמו נתיבי קבצים ופורמטים של נתונים. |
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של Operation.
היקפי הרשאה
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/cloud-platform
הרשאות IAM
נדרשת ההרשאה הבאה של IAM במשאב parent:
routeoptimization.operations.create
מידע נוסף זמין במאמרי העזרה של IAM.