REST Resource: eventticketobject

المورد: EventTicketObject

تمثيل JSON 
{
  "kind": string,
  "classReference": {
    object (EventTicketClass)
  },
  "seatInfo": {
    object (EventSeat)
  },
  "reservationInfo": {
    object (EventReservationInfo)
  },
  "ticketHolderName": string,
  "ticketNumber": string,
  "ticketType": {
    object (LocalizedString)
  },
  "faceValue": {
    object (Money)
  },
  "groupingInfo": {
    object (GroupingInfo)
  },
  "linkedOfferIds": [
    string
  ],
  "hexBackgroundColor": string,
  "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)
  },
  "rotatingBarcode": {
    object (RotatingBarcode)
  },
  "heroImage": {
    object (Image)
  },
  "passConstraints": {
    object (PassConstraints)
  },
  "saveRestrictions": {
    object (SaveRestrictions)
  },
  "linkedObjectIds": [
    string
  ],
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}
الحقول
kind
(deprecated)

string

لتحديد نوع المورد. القيمة: السلسلة الثابتة "walletobjects#eventTicketObject".
classReference

object (EventTicketClass)

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

object (EventSeat)

تفاصيل المقاعد لهذه التذكرة
reservationInfo

object (EventReservationInfo)

تفاصيل الحجز لهذه التذكرة ومن المتوقّع أن تتم مشاركة هذه المعلومات بين كل التذاكر التي تم شراؤها بالترتيب نفسه.
ticketHolderName

string

اسم حامل التذكرة، إذا كانت التذكرة مخصّصة لشخص معيّن على سبيل المثال، "خالد كمال" أو "هناء كمال".
ticketNumber

string

رقم التذكرة يمكن أن يكون هذا المعرّف فريدًا على مستوى جميع التذاكر في نظام جهة الإصدار أو جميع تذاكر الفعالية (مثل XYZ1234512345) أو جميع التذاكر في الطلب (1 و2 و3 وما إلى ذلك).
ticketType

object (LocalizedString)

نوع التذكرة، مثل "تذكرة شخص بالغ" أو "تذكرة طفل" أو "تذكرة VIP" أو "تذكرة عادية"
faceValue

object (Money)

القيمة الاسمية للتذكرة التي تتطابق مع ما ستتم طباعته على النسخة المادية من التذكرة
groupingInfo

object (GroupingInfo)

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

string

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

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

string

لون خلفية البطاقة. إذا لم يتم ضبطه، يتم استخدام اللون السائد لصورة العرض، وإذا لم يتم ضبط صورة عرض، يتم استخدام اللون السائد للشعار. يكون التنسيق على النحو التالي: #rrggbb حيث يكون rrggbb مجموعة RGB سداسية، مثل #ffcc00. يمكنك أيضًا استخدام النسخة المختصرة من مجموعة RGB الثلاثية وهي #rgb، مثل #fc0.
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. يتم ضبط هذا الحقل تلقائيًا على "خطأ".

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

object (InfoModuleData)

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

object (ImageModuleData)

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

object (TextModuleData)

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

object (RotatingBarcode)

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

object (Image)

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

object (PassConstraints)

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

object (SaveRestrictions)

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

string

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

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

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

enum (NotificationSettingsForUpdates)

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

object (ValueAddedModuleData)

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

EventSeat

تمثيل JSON 
{
  "kind": string,
  "seat": {
    object (LocalizedString)
  },
  "row": {
    object (LocalizedString)
  },
  "section": {
    object (LocalizedString)
  },
  "gate": {
    object (LocalizedString)
  }
}
الحقول
kind
(deprecated)

string

لتحديد نوع المورد. القيمة: السلسلة الثابتة "walletobjects#eventSeat".
seat

object (LocalizedString)

رقم المقعد، مثل "1" أو "2" أو "3" أو أي معرّف آخر للمقعد

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

object (LocalizedString)

صف المقعد، مثل 1 أو E أو BB أو A5.

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

object (LocalizedString)

قسم المقعد، مثل "121"

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

object (LocalizedString)

البوابة التي يجب أن يدخلها حامل التذكرة للوصول إلى مكانه، مثل "أ" أو "الغرب".

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

EventReservationInfo

تمثيل JSON 
{
  "kind": string,
  "confirmationCode": string
}
الحقول
kind
(deprecated)

string

لتحديد نوع المورد. القيمة: السلسلة الثابتة "walletobjects#eventReservationInfo".
confirmationCode

string

رمز تأكيد حجز الحدث. وقد يأخذ هذا الرقم أيضًا شكل "رقم الطلب" أو "رقم التأكيد" أو "رقم الحجز" أو ما شابه ذلك.

الطُرق

addmessage

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

get

 تعرِض هذه الدالة تذكرة الحدث باستخدام معرّف العنصر المحدّد.

insert

 تُدرج كائن تذكرة حضور بالمعرّف والخصائص المحددة.

list

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

modifylinkedofferobjects

 تعديل عناصر العروض المرتبطة لكائن تذكرة الحدث باستخدام المعرّف المحدّد

patch

 تعديل عنصر تذكرة الحدث المُشار إليه بمعرّف العنصر المحدّد

update

 تعديل عنصر تذكرة الحدث المُشار إليه بمعرّف العنصر المحدّد