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)
  }
}
الحقول
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 هو ثلاثي الأبعاد نموذج أحمر أخضر أزرق (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[]

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 ولقطات الشاشة.

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" أو "West".

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

EventReservationInfo

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

string

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

string

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

الطُرق

addmessage

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

get

 لعرض كائن طلب الحدث باستخدام رقم تعريف الكائن المحدّد.

insert

 يدرج عنصر تذكرة حدث برقم التعريف والخصائص المحددة.

list

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

modifylinkedofferobjects

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

patch

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

update

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