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