Method: providers.billableTrips.report

דיווח על שימוש בנסיעות לחיוב.

בקשת HTTP

POST https://fleetengine.googleapis.com/v1/{name=providers/*/billableTrips/*}:report

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

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

פרמטרים
name

string

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

גוף הבקשה

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

ייצוג ב-JSON 
{
  "countryCode": string,
  "platform": enum (BillingPlatformIdentifier),
  "relatedIds": [
    string
  ],
  "solutionType": enum (SolutionType)
}
שדות
countryCode

string

חובה. קוד מדינה בן שתי אותיות של המדינה שבה מתבצעת הנסיעה. המחיר מוגדר לפי קוד המדינה.
platform

enum (BillingPlatformIdentifier)

הפלטפורמה שבה הבקשה הוגשה.
relatedIds[]

string

המזהים שקשורים ישירות לנסיעה שמדווחים עליה. בדרך כלל מדובר במזהים (לדוגמה, מזהי סשנים) של פעולות שבוצעו לפני ההזמנה, לפני שמזהה הנסיעה זמין. מספר ה-relatedIds מוגבל ל-50.
solutionType

enum (SolutionType)

סוג הפתרון של מוצר GMP (למשל, ON_DEMAND_RIDESHARING_AND_DELIVERIES) ששימש לנסיעה שדווחה.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה הוא אובייקט JSON ריק.

BillingPlatformIdentifier

קבוצת ערכים שמציינים על איזו פלטפורמה הבקשה הוגשה.

טיפוסים בני מנייה (enum)
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED ברירת מחדל. משמש לפלטפורמות לא ספציפיות.
SERVER הפלטפורמה היא שרת לקוח.
WEB הפלטפורמה היא דפדפן אינטרנט.
ANDROID הפלטפורמה היא מכשיר נייד עם Android.
IOS הפלטפורמה היא מכשיר נייד עם iOS.
OTHERS פלטפורמות אחרות שלא מפורטות ברשימה הזו.

SolutionType

בורר לסוגי פתרונות שונים של נסיעה שדווחה.

טיפוסים בני מנייה (enum)
SOLUTION_TYPE_UNSPECIFIED ערך ברירת המחדל. כדי לשמור על תאימות לאחור, ה-API ישתמש ב-ON_DEMAND_RIDESHARING_AND_DELIVERIES כברירת מחדל, שהוא סוג הפתרון הראשון שנתמך.
ON_DEMAND_RIDESHARING_AND_DELIVERIES הפתרון הוא נסיעה משותפת ומשלוח על פי דרישה.