REST Resource: eventticketclass

{
  "kind": string,
  "eventName": {
    object (LocalizedString)
  },
  "eventId": string,
  "logo": {
    object (Image)
  },
  "venue": {
    object (EventVenue)
  },
  "dateTime": {
    object (EventDateTime)
  },
  "confirmationCodeLabel": enum (ConfirmationCodeLabel),
  "customConfirmationCodeLabel": {
    object (LocalizedString)
  },
  "seatLabel": enum (SeatLabel),
  "customSeatLabel": {
    object (LocalizedString)
  },
  "rowLabel": enum (RowLabel),
  "customRowLabel": {
    object (LocalizedString)
  },
  "sectionLabel": enum (SectionLabel),
  "customSectionLabel": {
    object (LocalizedString)
  },
  "gateLabel": enum (GateLabel),
  "customGateLabel": {
    object (LocalizedString)
  },
  "finePrint": {
    object (LocalizedString)
  },
  "classTemplateInfo": {
    object (ClassTemplateInfo)
  },
  "id": string,
  "version": string,
  "issuerName": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "allowMultipleUsersPerObject": boolean,
  "homepageUri": {
    object (Uri)
  },
  "locations": [
    {
      object (LatLongPoint)
    }
  ],
  "reviewStatus": enum (ReviewStatus),
  "review": {
    object (Review)
  },
  "infoModuleData": {
    object (InfoModuleData)
  },
  "imageModulesData": [
    {
      object (ImageModuleData)
    }
  ],
  "textModulesData": [
    {
      object (TextModuleData)
    }
  ],
  "linksModuleData": {
    object (LinksModuleData)
  },
  "redemptionIssuers": [
    string
  ],
  "countryCode": string,
  "heroImage": {
    object (Image)
  },
  "wordMark": {
    object (Image)
  },
  "enableSmartTap": boolean,
  "hexBackgroundColor": string,
  "localizedIssuerName": {
    object (LocalizedString)
  },
  "multipleDevicesAndHoldersAllowedStatus": enum (MultipleDevicesAndHoldersAllowedStatus),
  "callbackOptions": {
    object (CallbackOptions)
  },
  "securityAnimation": {
    object (SecurityAnimation)
  },
  "viewUnlockRequirement": enum (ViewUnlockRequirement),
  "wideLogo": {
    object (Image)
  },
  "notifyPreference": enum (NotificationSettingsForUpdates),
  "appLinkData": {
    object (AppLinkData)
  },
  "valueAddedModuleData": [
    {
      object (ValueAddedModuleData)
    }
  ]
}

string

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

object (LocalizedString)

مطلوب. اسم الحدث، مثل "LA Dodgers at SF Giants"

string

رقم تعريف الحدث. يجب أن يكون هذا المعرّف فريدًا لكلّ حدث في الحساب. ويتم استخدامه لتجميع التذاكر معًا إذا حفظ المستخدم تذاكر متعددة للفعالية نفسها. يجب ألا يزيد عدد أحرفها عن 64 حرفًا.

وفي حال توفّر هذه السمة، ستكون المجموعة ثابتة. احرِص على تجنُّب حدوث تداخل غير مقصود لتجنُّب تجميع التذاكر التي لا يجب تجميعها. إذا كنت تستخدم فئة واحدة فقط لكل حدث، يمكنك ببساطة ضبط هذا الإعداد على classId (مع جزء رقم تعريف جهة الإصدار أو بدونه).

إذا لم يتم توفير ذلك، ستحاول المنصة استخدام بيانات أخرى لتجميع التذاكر (من المحتمل أن تكون غير ثابتة).

object (Image)

صورة شعار التذكرة يتم عرض هذه الصورة في عرض تفاصيل البطاقة في التطبيق.

object (EventVenue)

تفاصيل مكان الحدث

object (EventDateTime)

معلومات التاريخ والوقت للحدث

enum (ConfirmationCodeLabel)

التصنيف الذي سيتم استخدامه لقيمة رمز التأكيد (eventTicketObject.reservationInfo.confirmationCode) في عرض تفاصيل البطاقة. يتم ربط كل خيار متاح بمجموعة من السلاسل المترجَمة، وذلك لعرض الترجمات للمستخدم استنادًا إلى لغته.

ربما لم يتم ضبط كل من confirmationCodeLabel وcustomConfirmationCodeLabel. وفي حال لم يتم ضبط أي منهما، سيتم ضبط التصنيف تلقائيًا على "رمز تأكيد البيانات"، بما يناسب السوق المحلية. إذا لم يتم ضبط حقل رمز التأكيد، لن يتم استخدام هذا التصنيف.

object (LocalizedString)

تصنيف مخصّص لاستخدامه مع قيمة رمز التأكيد (eventTicketObject.reservationInfo.confirmationCode) في عرض تفاصيل البطاقة يجب استخدام هذه السمة فقط إذا لم يكن التصنيف التلقائي "رمز التأكيد" أو أحد خيارات confirmationCodeLabel كافيًا.

ربما لم يتم ضبط كل من confirmationCodeLabel وcustomConfirmationCodeLabel. في حال عدم ضبط أيّ منهما، سيتم ضبط التصنيف تلقائيًا على "رمز التأكيد" المترجَم. إذا لم يتم ضبط حقل رمز التأكيد، لن يتم استخدام هذا التصنيف.

enum (SeatLabel)

التصنيف الذي سيتم استخدامه لقيمة المقعد (eventTicketObject.seatInfo.seat) في عرض تفاصيل البطاقة. يتم ربط كل خيار متاح بمجموعة من السلاسل المترجَمة، وذلك لعرض الترجمات للمستخدم استنادًا إلى لغته.

لا يمكن ضبط كل من seatLabel وcustomSeatLabel. وفي حال عدم ضبط أيّ منهما، سيتم ضبط التصنيف تلقائيًا على "المقعد" (مترجم). وفي حال ترك حقل المقعد بدون ضبط، لن يتم استخدام هذا التصنيف.

object (LocalizedString)

تصنيف مخصّص لاستخدامه مع قيمة المقعد (eventTicketObject.seatInfo.seat) في عرض تفاصيل البطاقة يجب استخدام هذه السمة فقط إذا لم يكن التصنيف التلقائي "المقعد" أو أحد خيارات "seatLabel" كافيًا.

ربما لم يتم ضبط كل من seatLabel وcustomSeatLabel. وفي حال عدم ضبط أيّ من الخيارَين، سيتم ضبط التصنيف تلقائيًا على "المقعد" (مترجم). إذا لم يتم ضبط حقل المقعد، لن يتم استخدام هذا التصنيف.

enum (RowLabel)

التصنيف المطلوب استخدامه لقيمة الصف (eventTicketObject.seatInfo.row) في عرض تفاصيل البطاقة. ويتم ربط كل خيار متاح بمجموعة من السلاسل المترجَمة، لكي يتم عرض الترجمات للمستخدم استنادًا إلى لغته.

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

object (LocalizedString)

تصنيف مخصّص لاستخدامه مع قيمة الصف (eventTicketObject.seatInfo.row) في عرض تفاصيل البطاقة. يجب عدم استخدام هذا الخيار إلا إذا لم يكن التصنيف التلقائي "صف" أو أحد خيارات rowLabel كافيًا.

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

enum (SectionLabel)

التصنيف الذي سيتم استخدامه لقيمة القسم (eventTicketObject.seatInfo.section) في عرض تفاصيل البطاقة. يتم ربط كل خيار متاح بمجموعة من السلاسل المترجَمة، وذلك لعرض الترجمات للمستخدم استنادًا إلى لغته.

ربما لم يتم ضبط كل من sectionLabel وcustomSectionLabel. وفي حال لم يتم ضبط أي منهما، سيتم ضبط التصنيف تلقائيًا على "قسم" (مترجَم). إذا لم يتم ضبط حقل القسم، لن يتم استخدام هذا التصنيف.

object (LocalizedString)

تصنيف مخصّص لاستخدامه مع قيمة القسم (eventTicketObject.seatInfo.section) في عرض تفاصيل البطاقة. يجب استخدام هذه السمة فقط إذا لم يكن التصنيف التلقائي "القسم" أو أحد خيارات "sectionLabel" كافيًا.

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

enum (GateLabel)

التصنيف الذي سيتم استخدامه لقيمة البوابة (eventTicketObject.seatInfo.gate) في عرض تفاصيل البطاقة. يتم ربط كل خيار متاح بمجموعة من السلاسل المترجَمة، وذلك لعرض الترجمات للمستخدم استنادًا إلى لغته.

لا يمكن ضبط كل من gateLabel وcustomGateLabel. وفي حال لم يتم ضبط أي منهما، سيتم ضبط التصنيف تلقائيًا على "بوابة" (مترجَم). إذا لم يتم ضبط حقل البوابة، لن يتم استخدام هذا التصنيف.

object (LocalizedString)

تصنيف مخصّص لاستخدامه مع قيمة البوابة (eventTicketObject.seatInfo.gate) في عرض تفاصيل البطاقة. يجب عدم استخدام هذا الخيار إلا إذا لم يكن التصنيف التلقائي "بوابة" أو أحد خيارات gateLabel كافيًا.

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

object (LocalizedString)

النص المكتوب بأحرف صغيرة أو الأحكام أو الشروط المتعلّقة بالتذكرة

object (ClassTemplateInfo)

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

string

مطلوب. المعرّف الفريد لأحد الصفوف يجب أن يكون هذا المعرّف فريدًا في جميع الفئات الصادرة عن جهة إصدار. يجب أن تكون هذه القيمة بالتنسيق issuer ID.identifier حيث تُصدر Google المعرّف الأول ويمكنك اختيار المعرّف الثاني. يجب أن يحتوي المعرّف الفريد على أحرف أبجدية رقمية أو "." أو "_" أو "-".

string (int64 format)

منهي العمل به

string

مطلوب. اسم جهة الإصدار الحد الأقصى المقترَح هو 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.

object (Message)

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

boolean

تمّ الإيقاف. استخدِم multipleDevicesAndHoldersAllowedStatus بدلاً من ذلك.

object (Uri)

معرّف الموارد المنتظم (URI) للصفحة الرئيسية للتطبيق. يؤدي ملء معرّف الموارد المنتظم في هذا الحقل إلى السلوك نفسه تمامًا الذي يؤدي إليه ملء معرّف الموارد المنتظم في linksModuleData (عند عرض عنصر، يظهر رابط إلى الصفحة الرئيسية في ما يُعتقد عادةً أنّه قسم linksModuleData من العنصر).

object (LatLongPoint)

ملاحظة: لا يمكن حاليًا استخدام هذا الحقل لتشغيل الإشعارات الجغرافية.

enum (ReviewStatus)

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

يجب إبقاء هذا الحقل في draft عندما يكون الصف قيد التطوير. لا يمكن استخدام فئة draft لإنشاء أي عنصر.

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

عند تعديل فئة approved، يجب مواصلة ضبط هذا الحقل على underReview.

object (Review)

تشير هذه السمة إلى تعليقات المراجعة التي ضبطتها المنصّة عند وضع علامة approved أو rejected على صف دراسي.

object (InfoModuleData)

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

object (ImageModuleData)

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

object (TextModuleData)

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

object (LinksModuleData)

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

string (int64 format)

لتحديد الجهات المُصدِرة التي يمكنها تحصيل قيمة البطاقة من خلال تكنولوجيا الدفع الذكي يتم تحديد الجهات المُصدِرة لعمليات تحصيل القيمة من خلال معرّف الجهة المُصدِرة. يجب أن يكون لدى جهات إصدار الرموز المميّزة مفتاح Smart Tap واحدًا على الأقل تم ضبطه.

يجب أيضًا إعداد الحقلَين enableSmartTap وsmartTapRedemptionLevel على مستوى العنصر بشكل صحيح لكي تتيح البطاقة ميزة "النقرة الذكية".

string

رمز البلد المستخدَم لعرض بلد البطاقة (عندما لا يكون المستخدم في ذلك البلد)، بالإضافة إلى عرض محتوى مترجَم عندما لا يتوفّر المحتوى بلغة المستخدم

object (Image)

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

object (Image)

تمّ الإيقاف.

boolean

تحدِّد ما إذا كانت هذه الفئة تتيح الدفع الذكي. يجب أيضًا إعداد الحقلَين redemptionIssuers وsmartTapRedemptionLevel على مستوى العنصر بشكل صحيح لكي تتيح البطاقة ميزة "النقرة الذكية".

string

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

object (LocalizedString)

سلاسل مترجمة لـ sourceName. يبلغ الحد الأقصى المقترَح للطول 20 حرفًا لضمان عرض السلسلة الكاملة على الشاشات الأصغر حجمًا.

enum (MultipleDevicesAndHoldersAllowedStatus)

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

object (CallbackOptions)

خيارات طلب معاودة الاتصال التي سيتم استخدامها للاتصال بالمُصدِر عند كل حفظ أو حذف عنصر من هذا النوع من قِبل المستخدم النهائي. جميع عناصر هذه الفئة مؤهَّلة للاتصال الخلفي.

object (SecurityAnimation)

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

enum (ViewUnlockRequirement)

اطّلِع على خيارات متطلبات فتح قفل تذكرة الحدث.

object (Image)

الشعار العريض للتذكرة عند تقديمها، سيتم استخدامها بدلاً من الشعار في أعلى يمين عرض البطاقة.

enum (NotificationSettingsForUpdates)

ما إذا كان من المفترض أن تؤدي تعديلات الحقول على هذه الفئة إلى إرسال إشعارات أم لا عند ضبط القيمة على NOTIFY (إشعار)، سنحاول إرسال إشعار إلى المستخدمين بشأن تعديل الحقل. ولن يتم إرسال هذه الإشعارات إلى المستخدمين إلا إذا كان الحقل جزءًا من القائمة المسموح بها. في حال عدم تحديده، لن يتم تشغيل أي إشعار. هذا الإعداد مؤقت ويجب ضبطه مع كل طلب PATCH أو UPDATE، وإلا لن يتم تشغيل إشعار.

object (AppLinkData)

رابط اختياري للتطبيق أو الموقع الإلكتروني سيتم عرضه كزر على الجهة الأمامية من البطاقة. إذا تم توفير AppLinkData للكائن المقابل الذي سيتم استخدامه بدلاً من ذلك.

object (ValueAddedModuleData)

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