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)
  }
}
الحقول
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، مثل #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[]

object (LatLongPoint)

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

boolean

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

string

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

boolean

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

boolean

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

في الوقت الحالي، لا يمكن ضبط هذا الإعداد إلا للعروض.
infoModuleData

object (InfoModuleData)

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

object (ImageModuleData)

بيانات وحدة الصورة الحدّ الأقصى لعدد هذه الحقول المعروضة هو 1 من مستوى العنصر و1 لمستوى عنصر الفئة.
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)

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

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)

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

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