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