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)

تمثّل هذه السمة نوع حلّ المنتج في "منصة Google للتسويق" (على سبيل المثال، 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 يتمثل الحل في رحلة مشاركة الرحلات والتسليم عند الطلب.