REST Resource: transitobject

المرجع: TransitObject

تمثيل JSON 
{
  "classReference": {
    object (TransitClass)
  },
  "ticketNumber": string,
  "passengerType": enum (PassengerType),
  "passengerNames": string,
  "tripId": string,
  "ticketStatus": enum (TicketStatus),
  "customTicketStatus": {
    object (LocalizedString)
  },
  "concessionCategory": enum (ConcessionCategory),
  "customConcessionCategory": {
    object (LocalizedString)
  },
  "ticketRestrictions": {
    object (TicketRestrictions)
  },
  "purchaseDetails": {
    object (PurchaseDetails)
  },
  "ticketLeg": {
    object (TicketLeg)
  },
  "ticketLegs": [
    {
      object (TicketLeg)
    }
  ],
  "hexBackgroundColor": string,
  "tripType": enum (TripType),
  "id": string,
  "classId": string,
  "version": string,
  "state": enum (State),
  "barcode": {
    object (Barcode)
  },
  "messages": [
    {
      object (Message)
    }
  ],
  "validTimeInterval": {
    object (TimeInterval)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "hasUsers": boolean,
  "smartTapRedemptionValue": string,
  "hasLinkedDevice": boolean,
  "disableExpirationNotification": boolean,
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "appLinkData": {
    object (AppLinkData)
  },
  "activationStatus": {
    object (ActivationStatus)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "deviceContext": {
    object (DeviceContext)
  },
  "heroImage": {
    object (Image)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
الحقول
classReference

object (TransitClass)

نسخة من الحقول المكتسَبة من الفئة الرئيسية يتم استرداد هذه الحقول أثناء طلب GET.
ticketNumber

string

رقم التذكرة هذا هو المعرّف الفريد للتذكرة في نظام مشغّل النقل العام.
passengerType

enum (PassengerType)

عدد الركاب
passengerNames

string

أسماء الركاب الذين تم تخصيص التذكرة لهم يهدف حقل passengerType أعلاه إلى تقديم سياق إلى Google حول هذا الحقل.
tripId

string

يُستخدَم هذا المعرّف لتجميع التذاكر معًا إذا حفظ المستخدم تذاكر متعددة للرحلة نفسها.
ticketStatus

enum (TicketStatus)

حالة التذكرة بالنسبة إلى الحالات التي تؤثّر في العرض، استخدِم الحقل state بدلاً من ذلك.
customTicketStatus

object (LocalizedString)

حالة مخصّصة لاستخدامها في قيمة حالة التذكرة عندما لا يوفّر ticketStatus الخيار الصحيح. لا يمكن ضبط كل من ticketStatus وcustomTicketStatus.
concessionCategory

enum (ConcessionCategory)

فئة الخصم للتذكرة.
customConcessionCategory

object (LocalizedString)

فئة مخصّصة للتنازلات لاستخدامها عندما لا يوفّر concessionCategory الخيار الصحيح. لا يمكن ضبط كل من concessionCategory وcustomConcessionCategory.
ticketRestrictions

object (TicketRestrictions)

معلومات عن نوع القيود المفروضة على استخدام هذا التذكرة على سبيل المثال، أيام الأسبوع التي يجب استخدامها فيها أو المسارات المسموح بالتنقّل فيها
purchaseDetails

object (PurchaseDetails)

تفاصيل شراء هذه التذكرة
ticketLeg

object (TicketLeg)

تحتوي رحلة واحدة في التذكرة على معلومات المغادرة والوصول بالإضافة إلى معلومات الصعود إلى الطائرة والمقاعد. إذا كان المطلوب تحديد أكثر من رحلة، استخدِم الحقل ticketLegs بدلاً من ذلك. لا يمكن ضبط كل من ticketLeg وticketLegs.
ticketLegs[]

object (TicketLeg)

قد تحتوي كل تذكرة على رحلة واحدة أو أكثر. تحتوي كل مرحلة على معلومات المغادرة والوصول بالإضافة إلى معلومات حول الصعود إلى الطائرة والمقاعد. إذا أردت تحديد رحلة واحدة فقط، استخدِم الحقل ticketLeg بدلاً من ذلك. لا يمكن ضبط كل من ticketLeg وticketLegs.
hexBackgroundColor

string

لون خلفية البطاقة. إذا لم يتم ضبطه، سيتم استخدام اللون السائد لصورة العرض، وإذا لم يتم ضبط صورة عرض، سيتم استخدام اللون السائد للشعار. يكون التنسيق على النحو التالي: #rrggbb حيث يكون rrggbb مجموعة سداسية عشرية من قيم RGB، مثل #ffcc00. يمكنك أيضًا استخدام الرمز المختصر للثلاثي RGB وهو #rgb، مثل #fc0.
tripType

enum (TripType)

مطلوب. نوع الرحلة التي يمثّلها عنصر النقل هذا تُستخدَم لتحديد عنوان البطاقة و/أو الرمز الذي سيتم استخدامه بين نقطة الانطلاق والوجهة.
id

string

مطلوب. المعرّف الفريد للعنصر يجب أن يكون هذا المعرّف فريدًا في جميع العناصر الصادرة عن جهة إصدار. يجب أن تكون هذه القيمة بالتنسيق issuer ID.identifier حيث يتم إصدار الأول من Google ويتم اختيار الثاني من قِبلك. يجب أن يتضمّن المعرّف الفريد أحرفًا أبجدية رقمية فقط أو النقطة أو الشرطة السفلية أو الواصلة.
classId

string

مطلوب. الصفّ المرتبط بهذا الكائن يجب أن يكون الصف من النوع نفسه مثل هذا العنصر، ويجب أن يكون متوفّرًا، ويجب أن تتم الموافقة عليه.

يجب أن تتّبع أرقام تعريف الصفوف التنسيق issuer ID.identifier حيث يتم إصدار الأول من Google ويتم اختيار الثاني من قِبلك.
version
(deprecated)

string (int64 format)

منهي العمل به
state

enum (State)

مطلوب. حالة العنصر يُستخدَم هذا الحقل لتحديد كيفية عرض عنصر في التطبيق. على سبيل المثال، يتم نقل عنصر inactive إلى قسم "البطاقات المنتهية الصلاحية".
barcode

object (Barcode)

نوع الرمز الشريطي وقيمته
messages[]

object (Message)

صفيف من الرسائل المعروضة في التطبيق. سيتلقّى جميع مستخدمي هذا العنصر الرسائل المرتبطة به. الحدّ الأقصى لعدد هذه الحقول هو 10.
validTimeInterval

object (TimeInterval)

الفترة الزمنية التي سيكون فيها هذا الكائن active ويمكن استخدام الكائن. سيتم تغيير حالة العنصر إلى expired بعد انقضاء هذه الفترة الزمنية.
locations[]
(deprecated)

object (LatLongPoint)

ملاحظة: لا يمكن حاليًا استخدام هذا الحقل لتشغيل الإشعارات الجغرافية.
hasUsers

boolean

تشير إلى ما إذا كان العنصر يتضمّن مستخدمين. تضبط المنصة هذا الحقل.
smartTapRedemptionValue

string

القيمة التي سيتم إرسالها إلى محطة دفع معتمَدة من Smart Tap عبر NFC لهذا العنصر. يجب أيضًا ضبط الحقلين enableSmartTap وredemptionIssuers على مستوى الفئة بشكل صحيح لكي تتيح البطاقة ميزة "النقرة الذكية". لا يمكن استخدام سوى أحرف ASCII.
hasLinkedDevice

boolean

ما إذا كان هذا العنصر مرتبطًا حاليًا بجهاز واحد يضبط النظام الأساسي هذا الحقل عندما يحفظ المستخدم العنصر ويربطه بجهازه. مخصّص للاستخدام من قِبل شركاء محدّدين. يُرجى التواصل مع فريق الدعم للحصول على معلومات إضافية.
disableExpirationNotification

boolean

يشير إلى ما إذا كان يجب إيقاف الإشعارات صراحةً. في حال ضبط هذا الحقل على "صحيح"، سيتم حظر إرسال إشعارات انتهاء الصلاحية إلى المستخدم بغض النظر عن حقل messages. يتم ضبط هذا الحقل تلقائيًا على false.

لا يمكن حاليًا ضبط هذه القيمة إلا للعروض.
infoModuleData

object (InfoModuleData)

تمّ الإيقاف. استخدِم textModulesData بدلاً من ذلك.
imageModulesData[]

object (ImageModuleData)

بيانات وحدة الصور الحد الأقصى لعدد هذه الحقول المعروضة هو حقل واحد من مستوى الكائن وحقل واحد من مستوى كائن الفئة.
textModulesData[]

object (TextModuleData)

بيانات وحدة النصوص إذا تمّ أيضًا تحديد بيانات وحدة النص في الفئة، سيتم عرض كليهما. الحد الأقصى لعدد هذه الحقول المعروضة هو 10 حقول من العنصر و10 حقول من الفئة.
activationStatus

object (ActivationStatus)

حالة التفعيل للعنصر. مطلوبة إذا تم ضبط activationOptions في الصف
rotatingBarcode

object (RotatingBarcode)

نوع الرمز الشريطي المتغيّر وقيمته
deviceContext

object (DeviceContext)

سياق الجهاز المرتبط بالعنصر
heroImage

object (Image)

صورة بانر اختيارية تظهر على واجهة البطاقة في حال عدم توفّر أيّ منها، سيتم عرض صورة رئيسية للفئة، إذا كانت متوفّرة. إذا لم تكن صورة العرض للصف متوفّرة أيضًا، لن يتم عرض أي محتوى.
groupingInfo

object (GroupingInfo)

المعلومات التي تتحكّم في كيفية تجميع البطاقات معًا
passConstraints

object (PassConstraints)

نقْل القيود للعنصر ويشمل ذلك الحدّ من سلوكيات NFC ولقطات الشاشة.
saveRestrictions

object (SaveRestrictions)

القيود المفروضة على العنصر التي يجب التحقّق منها قبل أن يحاول المستخدم حفظ البطاقة يُرجى العلم أنّ هذه القيود لن يتم تطبيقها إلا خلال وقت الحفظ. إذا تغيّرت القيود بعد أن يحفظ المستخدم البطاقة، لن يتم تطبيق القيود الجديدة على بطاقة سبق حفظها.
linkedObjectIds[]

string

تمثل ‎linkedObjectIds قائمة بعناصر أخرى، مثل تذكرة حضور فعالية أو بطاقة ولاء أو عرض أو بطاقة عامة أو بطاقة هدايا أو بطاقة نقل عام أو بطاقة صعود طائرة، والتي يجب إرفاقها تلقائيًا بعنصر النقل العام هذا. إذا حفظ مستخدم بطاقة النقل العام هذه، سيتم تلقائيًا إرسال معرّفات linkedObjectIds هذه إلى محفظة المستخدم (ما لم يوقف الإعداد لتلقّي البطاقات المرتبطة هذه).

تأكَّد من أنّه سبق إدراج العناصر المتوفّرة في linkedObjectIds، وإلا ستتعذّر عمليات الاستدعاء. بعد ربط العناصر، لا يمكن إلغاء ربطها. لا يمكنك ربط عناصر تابعة لمُصدِر آخر. هناك حدّ أقصى لعدد العناصر التي يمكن ربطها بعنصر واحد. بعد بلوغ الحدّ الأقصى، سيتم تجاهل الكائنات الجديدة المرتبطة في المكالمة بدون إشعار.

يجب أن تتّبع معرّفات العناصر التنسيق issuer ID.identifier حيث تُصدر Google المعرّف الأول ويمكنك اختيار المعرّف الثاني.
notifyPreference

enum (NotificationSettingsForUpdates)

ما إذا كان يجب أن تؤدي تعديلات الحقل على هذا العنصر إلى إرسال إشعارات أم لا عند ضبط القيمة على NOTIFY (إشعار)، سنحاول إرسال إشعار إلى المستخدمين بشأن تعديل الحقل. ولن يتم إرسال هذه الإشعارات إلى المستخدمين إلا إذا كان الحقل جزءًا من قائمة مسموح بها. في حال ضبط القيمة على DO_NOT_NOTIFY أو NOTIFICATION_SETTINGS_UNSPECIFIED، لن يتم تشغيل أي إشعار. هذا الإعداد مؤقت ويجب ضبطه مع كل طلب PATCH أو UPDATE، وإلا لن يتم تشغيل إشعار.
valueAddedModuleData[]

object (ValueAddedModuleData)

بيانات اختيارية لمكوّنات القيمة المضافة عشرة عناصر كحد أقصى على الجسم

PassengerType

عمليات التعداد
PASSENGER_TYPE_UNSPECIFIED
SINGLE_PASSENGER
singlePassenger

اسم بديل قديم لـ SINGLE_PASSENGER تمّ الإيقاف.
MULTIPLE_PASSENGERS
multiplePassengers

اسم بديل قديم لـ MULTIPLE_PASSENGERS تمّ الإيقاف.

TicketStatus

عمليات التعداد
TICKET_STATUS_UNSPECIFIED
USED
used

اسم بديل قديم لـ USED تمّ الإيقاف.
REFUNDED
refunded

اسم بديل قديم لـ REFUNDED تمّ الإيقاف.
EXCHANGED
exchanged

اسم بديل قديم لـ EXCHANGED تمّ الإيقاف.

ConcessionCategory

عمليات التعداد
CONCESSION_CATEGORY_UNSPECIFIED
ADULT
adult

اسم بديل قديم لـ ADULT تمّ الإيقاف.
CHILD
child

اسم بديل قديم لـ CHILD تمّ الإيقاف.
SENIOR
senior

اسم بديل قديم لـ SENIOR تمّ الإيقاف.

TicketRestrictions

تمثيل JSON 
{
  "routeRestrictions": {
    object (LocalizedString)
  },
  "routeRestrictionsDetails": {
    object (LocalizedString)
  },
  "timeRestrictions": {
    object (LocalizedString)
  },
  "otherRestrictions": {
    object (LocalizedString)
  }
}
الحقول
routeRestrictions

object (LocalizedString)

القيود المفروضة على المسارات التي يمكن اتّخاذها على سبيل المثال، قد تكون السلسلة "القطارات المحجوزة في CrossCountry فقط".
routeRestrictionsDetails

object (LocalizedString)

مزيد من التفاصيل حول routeRestrictions أعلاه
timeRestrictions

object (LocalizedString)

القيود المفروضة على أوقات استخدام هذه التذكرة
otherRestrictions

object (LocalizedString)

قيود إضافية لا تندرج ضمن فئتَي "المسار" أو "الوقت"

PurchaseDetails

تمثيل JSON 
{
  "purchaseReceiptNumber": string,
  "purchaseDateTime": string,
  "accountId": string,
  "confirmationCode": string,
  "ticketCost": {
    object (TicketCost)
  }
}
الحقول
purchaseReceiptNumber

string

رقم الإيصال/المعرّف لتتبُّع عملية شراء التذكرة من خلال الجهة التي باعت التذكرة
purchaseDateTime

string

تاريخ/وقت شراء التذكرة

هذا هو تاريخ/وقت بتنسيق ISO 8601 الموسّع، مع أو بدون مدة زمنية. يمكن تحديد الوقت بدقة تصل إلى النانو ثانية. يمكن تحديد البادئات بدقة الثواني (على الرغم من أنّ الثواني في البادئة ليست جزءًا من معيار ISO 8601).

على سبيل المثال:

سيكون 1985-04-12T23:20:50.52Z بعد 20 دقيقة و50.52 ثانية من الساعة 23 من يوم 12 نيسان (أبريل) 1985 بالتوقيت العالمي المتفق عليه.

سيكون 1985-04-12T19:20:50.52-04:00 بعد 20 دقيقة و50.52 ثانية من الساعة 19 من يوم 12 نيسان (أبريل) 1985، أي قبل 4 ساعات من التوقيت العالمي المتفق عليه (اللحظة نفسها في الوقت المحدّدة في المثال أعلاه). إذا كان الحدث في نيويورك، سيكون هذا هو التوقيت المكافئ للتوقيت الصيفي الشرقي (EDT). تذكَّر أنّ فرق التوقيت يختلف في المناطق التي تطبّق التوقيت الصيفي (أو التوقيت الصيفي)، وذلك حسب الوقت من السنة.

سيكون 1985-04-12T19:20:50.52 بعد 20 دقيقة و50.52 ثانية من الساعة 19 من يوم 12 نيسان (أبريل) 1985 بدون معلومات عن المدة الزمنية.

بدون معلومات البدء، قد لا تتوفّر بعض الميزات الغنية.
accountId

string

رقم تعريف الحساب المستخدَم لشراء التذكرة
confirmationCode

string

رمز تأكيد عملية الشراء قد تكون هذه القيمة متطابقة لعدة تذاكر مختلفة، ويتم استخدامها لتجميع التذاكر معًا.
ticketCost

object (TicketCost)

تكلفة التذكرة.

TicketCost

تمثيل JSON 
{
  "faceValue": {
    object (Money)
  },
  "purchasePrice": {
    object (Money)
  },
  "discountMessage": {
    object (LocalizedString)
  }
}
الحقول
faceValue

object (Money)

القيمة الاسمية للتذكرة
purchasePrice

object (Money)

سعر الشراء الفعلي للتذكرة بعد احتساب الضريبة و/أو الخصومات
discountMessage

object (LocalizedString)

رسالة تصف أي نوع من الخصومات التي تم تطبيقها

TicketLeg

تمثيل JSON 
{
  "originStationCode": string,
  "originName": {
    object (LocalizedString)
  },
  "destinationStationCode": string,
  "destinationName": {
    object (LocalizedString)
  },
  "departureDateTime": string,
  "arrivalDateTime": string,
  "fareName": {
    object (LocalizedString)
  },
  "carriage": string,
  "platform": string,
  "zone": string,
  "ticketSeat": {
    object (TicketSeat)
  },
  "ticketSeats": [
    {
      object (TicketSeat)
    }
  ],
  "transitOperatorName": {
    object (LocalizedString)
  },
  "transitTerminusName": {
    object (LocalizedString)
  }
}
الحقول
originStationCode

string

رمز المحطة الأصلية. يجب استخدام هذه السمة إذا كانت السمة destinationStationCode متوفّرة أو إذا لم تكن السمة originName متوفّرة.
originName

object (LocalizedString)

اسم المحطة الأصلية يجب استخدام هذه السمة إذا كانت السمة desinationName متوفّرة أو إذا لم تكن السمة originStationCode متوفّرة.
destinationStationCode

string

رمز محطة الوجهة
destinationName

object (LocalizedString)

اسم الوجهة
departureDateTime

string

تاريخ/وقت المغادرة يجب استخدام هذه السمة إذا لم يتم ضبط فاصل زمني للصلاحية على عنصر النقل.

هذا هو تاريخ/وقت بتنسيق ISO 8601 الموسّع، مع أو بدون مدة زمنية. يمكن تحديد الوقت بدقة تصل إلى النانو ثانية. يمكن تحديد البادئات بدقة الثواني (على الرغم من أنّ الثواني في البادئة ليست جزءًا من معيار ISO 8601).

على سبيل المثال:

سيكون 1985-04-12T23:20:50.52Z بعد 20 دقيقة و50.52 ثانية من الساعة 23 من يوم 12 نيسان (أبريل) 1985 بالتوقيت العالمي المتفق عليه.

سيكون 1985-04-12T19:20:50.52-04:00 بعد 20 دقيقة و50.52 ثانية من الساعة 19 من يوم 12 نيسان (أبريل) 1985، أي قبل 4 ساعات من التوقيت العالمي المتفق عليه (اللحظة نفسها في الوقت المحدّدة في المثال أعلاه). إذا كان الحدث في نيويورك، سيكون هذا هو التوقيت المكافئ للتوقيت الصيفي الشرقي (EDT). تذكَّر أنّ فرق التوقيت يختلف في المناطق التي تطبّق التوقيت الصيفي (أو التوقيت الصيفي)، وذلك حسب الوقت من السنة.

سيكون 1985-04-12T19:20:50.52 بعد 20 دقيقة و50.52 ثانية من الساعة 19 من يوم 12 نيسان (أبريل) 1985 بدون معلومات عن المدة الزمنية.

يُعتبر الجزء من التاريخ/الوقت بدون المدة الزمنية "التاريخ/الوقت المحلي". يجب أن يكون هذا التاريخ/الوقت هو التاريخ/الوقت المحلي في المحطة الأصلية. على سبيل المثال، إذا كان موعد المغادرة في الساعة 20 من يوم 5 حزيران (يونيو) 2018 في المحطة الأصلية، يجب أن يكون جزء التاريخ/الوقت المحلي 2018-06-05T20:00:00. إذا كان التاريخ أو الوقت المحليان في المحطة الأصلية قبل التوقيت العالمي المنسّق بـ 4 ساعات، قد تتم إضافة فرق زمني قدره -04:00.

بدون معلومات البدء، قد لا تتوفّر بعض الميزات الغنية.
arrivalDateTime

string

تاريخ/وقت الوصول

هذا هو تاريخ/وقت بتنسيق ISO 8601 الموسّع، مع أو بدون مدة زمنية. يمكن تحديد الوقت بدقة تصل إلى النانو ثانية. يمكن تحديد البادئات بدقة الثواني (على الرغم من أنّ الثواني في البادئة ليست جزءًا من معيار ISO 8601).

على سبيل المثال:

سيكون 1985-04-12T23:20:50.52Z بعد 20 دقيقة و50.52 ثانية من الساعة 23 من يوم 12 نيسان (أبريل) 1985 بالتوقيت العالمي المتفق عليه.

سيكون 1985-04-12T19:20:50.52-04:00 بعد 20 دقيقة و50.52 ثانية من الساعة 19 من يوم 12 نيسان (أبريل) 1985، أي قبل 4 ساعات من التوقيت العالمي المتفق عليه (اللحظة نفسها في الوقت المحدّدة في المثال أعلاه). إذا كان الحدث في نيويورك، سيكون هذا هو التوقيت المكافئ للتوقيت الصيفي الشرقي (EDT). تذكَّر أنّ فرق التوقيت يختلف في المناطق التي تطبّق التوقيت الصيفي (أو التوقيت الصيفي)، وذلك حسب الوقت من السنة.

سيكون 1985-04-12T19:20:50.52 بعد 20 دقيقة و50.52 ثانية من الساعة 19 من يوم 12 نيسان (أبريل) 1985 بدون معلومات عن المدة الزمنية.

يُعتبر الجزء من التاريخ/الوقت بدون المدة الزمنية "التاريخ/الوقت المحلي". يجب أن يكون هذا هو التاريخ أو الوقت المحلي في المحطة المقصودة. على سبيل المثال، إذا حدثت الفعالية في الساعة 20 من يوم 5 حزيران (يونيو) 2018 في المحطة المقصودة، يجب أن يكون جزء التاريخ/الوقت المحلي هو 2018-06-05T20:00:00. إذا كان التاريخ أو الوقت المحليان في المحطة المقصودة قبل التوقيت العالمي المنسق بـ 4 ساعات، قد تتم إضافة فاصل زمني قدره -04:00.

بدون معلومات البدء، قد لا تتوفّر بعض الميزات الغنية.
fareName

object (LocalizedString)

وصف/اسم مختصر للتعريفة لهذه المرحلة من الرحلة على سبيل المثال، "استخدام لمرة واحدة في أي وقت".
carriage

string

اسم القطار أو السفينة أو رقمهما اللذان يحتاج المسافر إلى ركوبهما
platform

string

المنصة أو البوابة التي يمكن للراكب من خلالها ركوب العربة
zone

string

منطقة الصعود إلى الطائرة داخل المنصة
ticketSeat

object (TicketSeat)

المقعد المحجوز للمسافرين إذا كان المطلوب تحديد أكثر من مقعد واحد، استخدِم الحقل ticketSeats بدلاً من ذلك. لا يمكن ضبط كل من ticketSeat وticketSeats.
ticketSeats[]

object (TicketSeat)

المقعد المحجوز للمسافرين إذا كان المطلوب تحديد مقعد واحد فقط، استخدِم الحقل ticketSeat بدلاً من ذلك. لا يمكن ضبط كل من ticketSeat وticketSeats.
transitOperatorName

object (LocalizedString)

اسم مشغّل خدمة النقل الذي يدير هذه المرحلة من الرحلة
transitTerminusName

object (LocalizedString)

محطة أو وجهة القطار/الحافلة/غير ذلك

TicketSeat

تمثيل JSON 
{
  "fareClass": enum (FareClass),
  "customFareClass": {
    object (LocalizedString)
  },
  "coach": string,
  "seat": string,
  "seatAssignment": {
    object (LocalizedString)
  }
}
الحقول
fareClass

enum (FareClass)

فئة السعر للمقعد الذي تم شراء تذكرة له
customFareClass

object (LocalizedString)

فئة تعرفة مخصّصة ليتم استخدامها في حال عدم تطبيق fareClass لا يمكن ضبط كل من fareClass وcustomFareClass.
coach

string

معرّف عربة القطار التي يقع فيها المقعد المُشارَك في التذكرة على سبيل المثال: "10"
seat

string

معرّف مكان المقعد المرتبط بتذكرة على سبيل المثال: "42". إذا لم يكن هناك معرّف محدّد، استخدِم seatAssigment بدلاً من ذلك.
seatAssignment

object (LocalizedString)

مقعد الراكب المحدَّد على سبيل المثال: "لم يتم اختيار أي مقعد". يُستخدَم هذا المقياس عندما لا يتوفّر معرّف محدّد لاستخدامه في seat.

FareClass

عمليات التعداد
FARE_CLASS_UNSPECIFIED
ECONOMY
economy

اسم بديل قديم لـ ECONOMY تمّ الإيقاف.
FIRST
first

اسم بديل قديم لـ FIRST تمّ الإيقاف.
BUSINESS
business

اسم بديل قديم لـ BUSINESS تمّ الإيقاف.

TripType

عمليات التعداد
TRIP_TYPE_UNSPECIFIED
ROUND_TRIP
roundTrip

اسم بديل قديم لـ ROUND_TRIP تمّ الإيقاف.
ONE_WAY
oneWay

اسم بديل قديم لـ ONE_WAY تمّ الإيقاف.

ActivationStatus

حالة تفعيل العنصر. يتضمّن هذا الحقل حالة التفعيل إذا كانت القيمة تتيح التفعيل.

تمثيل JSON 
{
  "state": enum (State)
}
الحقول
state

enum (State)

الحالة

عمليات التعداد
UNKNOWN_STATE
NOT_ACTIVATED غير مفعّل، هذه هي الحالة التلقائية
not_activated

اسم بديل قديم لـ NOT_ACTIVATED تمّ الإيقاف.
ACTIVATED مفعّل
activated

اسم بديل قديم لـ ACTIVATED تمّ الإيقاف.

DeviceContext

سياق الجهاز المرتبط بالعنصر

تمثيل JSON 
{
  "deviceToken": string
}
الحقول
deviceToken

string

في حال ضبطها، لن يتم عرض معلومات تحصيل القيمة إلا على الجهاز المحدّد عند تفعيل العنصر. ولا يجوز استخدامه كمعرّف ثابت لتتبُّع جهاز المستخدم. ويمكن أن يختلف ذلك من بطاقة إلى أخرى للجهاز نفسه أو حتى من عملية تفعيل إلى أخرى للجهاز نفسه. عند ضبط هذا الإعداد، على المتصلين أيضًا ضبط hasLinkedDevice على العنصر الذي يتم تفعيله.

الطُرق

addmessage

 تُضيف رسالة إلى عنصر النقل المُشار إليه بمعرّف العنصر المحدّد.

get

 تعرِض هذه الدالة عنصر النقل الذي يحمل رقم تعريف العنصر المحدّد.

insert

 تُدرج عنصرًا للنقل العام باستخدام رقم التعريف والسمات المحدّدة.

list

 تعرِض هذه الدالة قائمة بجميع عناصر النقل لمعرّف جهة إصدار معيّن.

patch

 تعديل عنصر النقل المُشار إليه بمعرّف العنصر المحدّد

update

 تعديل عنصر النقل المُشار إليه بمعرّف العنصر المحدّد