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)
  }
}
الحقول
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)

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

object (Money)

تمثّل هذه السمة القيمة الاسمية للتذكرة، وتتطابق مع ما ستتم طباعته على النسخة المطبوعة منها.
groupingInfo

object (GroupingInfo)

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

string

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

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

string

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

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 من الفئة.
rotatingBarcode

object (RotatingBarcode)

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

object (Image)

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

object (PassConstraints)

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

object (SaveRestrictions)

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

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)

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

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

EventReservationInfo

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

string

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

string

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

الطُرق

addmessage

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

get

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

insert

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

list

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

modifylinkedofferobjects

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

patch

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

update

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