Method: projects.batchOptimizeTours

אופטימיזציה של סיורים לכלי רכב עבור הודעה אחת או יותר מסוג 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 משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
parent

string

חובה. בחירת הפרויקט והמיקום לקריאה.

פורמט: * projects/{project-id} * projects/{project-id}/locations/{location-id}

אם לא מציינים מיקום, המערכת בוחרת אזור באופן אוטומטי.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "modelConfigs": [
    {
      object (AsyncModelConfig)
    }
  ]
}
שדות
modelConfigs[]

object (AsyncModelConfig)

חובה. פרטי קלט/פלט של כל מודל רכישה, כמו נתיבי קבצים ופורמטים של נתונים.

גוף התשובה

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

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/cloud-platform

הרשאות IAM

נדרשת ההרשאה הבאה ב-IAM במשאב parent:

  • routeoptimization.operations.create

למידע נוסף, עיינו במסמכי העזרה של IAM.