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) المستخدَم في الرحلة التي تم الإبلاغ عنها.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.

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 الحل هو رحلة مشاركة الرحلات والتوصيل عند الطلب.