Method: providers.billableTrips.report

الإبلاغ عن استخدام الرحلات المشمولة في الفاتورة

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز 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

مجموعة من القيم التي تشير إلى المنصة التي تم إصدار الطلب عليها

عمليات التعداد
BILLING_PLATFORM_IDENTIFIER_UNSPECIFIED تلقائي: يُستخدَم للأنظمة الأساسية غير المحدّدة.
SERVER المنصة هي خادم عملاء.
WEB المنصة هي متصفح ويب.
ANDROID النظام الأساسي هو جهاز جوّال Android.
IOS النظام الأساسي هو جهاز جوّال يعمل بنظام التشغيل iOS.
OTHERS المنصات الأخرى غير المُدرَجة في هذا التعداد

SolutionType

أداة اختيار لأنواع الحلول المختلفة لرحلة تم الإبلاغ عنها

عمليات التعداد
SOLUTION_TYPE_UNSPECIFIED القيمة التلقائية للتوافق مع الإصدارات القديمة، ستستخدم واجهة برمجة التطبيقات ON_DEMAND_RIDESHARING_AND_DELIVERIES تلقائيًا، وهو أول نوع من الحلول المتوافقة.
ON_DEMAND_RIDESHARING_AND_DELIVERIES يتمثل الحل في رحلة مشاركة ركوب وتسليم عند الطلب.