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 عبارة عن ثلاثي بنموذج أحمر أخضر أزرق سداسي، مثل #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

القيمة التي سيتم إرسالها إلى محطة دفع معتمَدة من خلال تكنولوجيا "الدفع الذكي" عبر 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، وإلا ستتعذّر عمليات الاستدعاء. بعد ربط العناصر، لا يمكن إلغاء ربطها. لا يمكنك ربط عناصر تنتمي إلى جهة إصدار أخرى. هناك حدّ أقصى لعدد العناصر التي يمكن ربطها بعنصر واحد. بعد بلوغ الحدّ الأقصى، سيتم تجاهل الكائنات المرتبطة الجديدة في المكالمة بدون إشعار.

يجب أن تتّبع معرّفات العناصر التنسيق 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 ساعات من التوقيت العالمي المنسق (UTC)، قد يتم إلحاق إزاحة -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 ساعات من التوقيت العالمي المنسق (UTC)، قد يتم إلحاق إزاحة -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

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