REST Resource: eventticketclass

المرجع: EventTicketClass

تمثيل JSON 
{
  "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)
    }
  ]
}
الحقول
kind
(deprecated)

string

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

object (LocalizedString)

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

string

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

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

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

object (EventVenue)

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

object (EventDateTime)

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

enum (ConfirmationCodeLabel)

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

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

object (LocalizedString)

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

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

enum (SeatLabel)

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

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

object (LocalizedString)

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

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

enum (RowLabel)

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

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

object (LocalizedString)

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

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

enum (SectionLabel)

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

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

object (LocalizedString)

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

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

enum (GateLabel)

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

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

object (LocalizedString)

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

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

object (LocalizedString)

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

object (ClassTemplateInfo)

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

string

مطلوب. المعرّف الفريد لأحد الصفوف يجب أن يكون هذا المعرّف فريدًا في جميع الفئات الصادرة عن جهة إصدار. يجب أن تتبع هذه القيمة التنسيق issuer ID.identifier حيث تُصدر Google المعرّف الأول ويمكنك اختيار المعرّف الثاني. يجب أن يتضمّن المعرّف الفريد أحرفًا أبجدية رقمية فقط أو النقطة أو الشرطة السفلية أو الشرطة المائلة.
version
(deprecated)

string (int64 format)

منهي العمل به
issuerName

string

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

object (Message)

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

boolean

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

object (Uri)

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

object (LatLongPoint)

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

enum (ReviewStatus)

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

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

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

عند تعديل صف دراسي واحد (approved)، عليك مواصلة ضبط هذا الحقل على underReview.
review

object (Review)

تعليقات المراجعة التي تحدّدها المنصة عند وضع علامة approved أو rejected على الصف
infoModuleData
(deprecated)

object (InfoModuleData)

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

object (ImageModuleData)

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

object (TextModuleData)

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

string (int64 format)

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

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

string

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

object (Image)

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

object (Image)

تمّ الإيقاف.
enableSmartTap

boolean

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

string

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

object (LocalizedString)

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

enum (MultipleDevicesAndHoldersAllowedStatus)

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

object (CallbackOptions)

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

object (SecurityAnimation)

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

enum (ViewUnlockRequirement)

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

enum (NotificationSettingsForUpdates)

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

object (ValueAddedModuleData)

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

EventVenue

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

string

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

object (LocalizedString)

اسم المكان، مثل "AT&T Park"

هذا الحقل مطلوب.
address

object (LocalizedString)

عنوان المكان، مثل "24 Willie Mays Plaza\nSan Francisco, CA 94107" يتم الفصل بين أسطر العناوين بأحرف خلاصة الأسطر (\n).

هذا الحقل مطلوب.

EventDateTime

تمثيل JSON 
{
  "kind": string,
  "doorsOpen": string,
  "start": string,
  "end": string,
  "doorsOpenLabel": enum (DoorsOpenLabel),
  "customDoorsOpenLabel": {
    object (LocalizedString)
  }
}
الحقول
kind
(deprecated)

string

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

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 ساعات من التوقيت العالمي المتفق عليه (اللحظة نفسها في الوقت المحدّدة في المثال أعلاه). إذا كان الحدث في نيويورك، سيكون هذا هو التوقيت المكافئ للتوقيت الصيفي الشرقي (EDT). تجدر الإشارة إلى أنّ التوقيت يختلف في المناطق التي تطبّق التوقيت الصيفي (أو التوقيت الصيفي)، بناءً على الوقت من السنة.

ستكون 1985-04-12T19:20:50.52 بعد 20 دقيقة و50.52 ثانية من الساعة 19 من 12 نيسان (أبريل) 1985 بدون أي معلومات إزاحة.

كما أن الجزء من التاريخ/الوقت بدون الإزاحة يعتبر "التاريخ/الوقت المحلي". يجب أن يكون هذا التاريخ/الوقت هو التاريخ/الوقت المحلي في المكان. على سبيل المثال، إذا كان موعد الفعالية في الساعة 20 من يوم 5 حزيران (يونيو) 2018 في مكان الحدث، يجب أن يكون جزء التاريخ/الوقت المحلي هو 2018-06-05T20:00:00. إذا كان التاريخ أو الوقت المحلي في المكان قبل التوقيت العالمي المتفق عليه بـ 4 ساعات، قد تتم إضافة فاصل زمني قدره -04:00.

بدون معلومات الإزاحة، قد لا تتوفّر بعض الميزات المنسّقة.
start

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 ساعات من التوقيت العالمي المتفق عليه (اللحظة نفسها في الوقت المحدّدة في المثال أعلاه). إذا كان الحدث في نيويورك، سيكون هذا هو التوقيت المكافئ للتوقيت الصيفي الشرقي (EDT). تجدر الإشارة إلى أنّ التوقيت يختلف في المناطق التي تطبّق التوقيت الصيفي (أو التوقيت الصيفي)، بناءً على الوقت من السنة.

ستكون 1985-04-12T19:20:50.52 بعد 20 دقيقة و50.52 ثانية من الساعة 19 من 12 نيسان (أبريل) 1985 بدون أي معلومات إزاحة.

كما أن الجزء من التاريخ/الوقت بدون الإزاحة يعتبر "التاريخ/الوقت المحلي". يجب أن يكون هذا التاريخ/الوقت هو التاريخ/الوقت المحلي في المكان. على سبيل المثال، إذا كان موعد الفعالية في الساعة 20 من يوم 5 حزيران (يونيو) 2018 في مكان الحدث، يجب أن يكون جزء التاريخ/الوقت المحلي هو 2018-06-05T20:00:00. إذا كان التاريخ أو الوقت المحلي في المكان قبل التوقيت العالمي المتفق عليه بـ 4 ساعات، قد تتم إضافة فاصل زمني قدره -04:00.

بدون معلومات البدء، قد لا تتوفّر بعض الميزات الغنية.
end

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 ساعات من التوقيت العالمي المتفق عليه (اللحظة نفسها في الوقت المحدّدة في المثال أعلاه). إذا كان الحدث في نيويورك، سيكون هذا هو التوقيت المكافئ للتوقيت الصيفي الشرقي (EDT). تجدر الإشارة إلى أنّ التوقيت يختلف في المناطق التي تطبّق التوقيت الصيفي (أو التوقيت الصيفي)، بناءً على الوقت من السنة.

ستكون 1985-04-12T19:20:50.52 بعد 20 دقيقة و50.52 ثانية من الساعة 19 من 12 نيسان (أبريل) 1985 بدون أي معلومات إزاحة.

كما أن الجزء من التاريخ/الوقت بدون الإزاحة يعتبر "التاريخ/الوقت المحلي". يجب أن يكون هذا التاريخ/الوقت هو التاريخ/الوقت المحلي في المكان. على سبيل المثال، إذا كان موعد الفعالية في الساعة 20 من يوم 5 حزيران (يونيو) 2018 في مكان الحدث، يجب أن يكون جزء التاريخ/الوقت المحلي هو 2018-06-05T20:00:00. إذا كان التاريخ أو الوقت المحلي في المكان قبل التوقيت العالمي المتفق عليه بـ 4 ساعات، قد تتم إضافة فاصل زمني قدره -04:00.

بدون معلومات البدء، قد لا تتوفّر بعض الميزات الغنية.
doorsOpenLabel

enum (DoorsOpenLabel)

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

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

object (LocalizedString)

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

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

DoorsOpenLabel

عمليات التعداد
DOORS_OPEN_LABEL_UNSPECIFIED
DOORS_OPEN
doorsOpen

اسم بديل قديم لـ DOORS_OPEN تمّ الإيقاف.
GATES_OPEN
gatesOpen

اسم بديل قديم لـ GATES_OPEN تمّ الإيقاف.

ConfirmationCodeLabel

عمليات التعداد
CONFIRMATION_CODE_LABEL_UNSPECIFIED
CONFIRMATION_CODE
confirmationCode

اسم بديل قديم لـ CONFIRMATION_CODE تمّ الإيقاف.
CONFIRMATION_NUMBER
confirmationNumber

اسم بديل قديم لـ CONFIRMATION_NUMBER تمّ الإيقاف.
ORDER_NUMBER
orderNumber

اسم بديل قديم لـ ORDER_NUMBER تمّ الإيقاف.
RESERVATION_NUMBER
reservationNumber

الاسم المستعار القديم لـ RESERVATION_NUMBER. تمّ الإيقاف.

SeatLabel

عمليات التعداد
SEAT_LABEL_UNSPECIFIED
SEAT
seat

اسم بديل قديم لـ SEAT تمّ الإيقاف.

RowLabel

عمليات التعداد
ROW_LABEL_UNSPECIFIED
ROW
row

الاسم المستعار القديم لـ ROW. تمّ الإيقاف.

SectionLabel

عمليات التعداد
SECTION_LABEL_UNSPECIFIED
SECTION
section

اسم بديل قديم لـ SECTION تمّ الإيقاف.
THEATER
theater

اسم بديل قديم لـ THEATER تمّ الإيقاف.

GateLabel

عمليات التعداد
GATE_LABEL_UNSPECIFIED
GATE
gate

اسم بديل قديم لـ GATE تمّ الإيقاف.
DOOR
door

اسم بديل قديم لـ DOOR تمّ الإيقاف.
ENTRANCE
entrance

الاسم المستعار القديم لـ ENTRANCE. تمّ الإيقاف.

الطُرق

addmessage

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

get

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

insert

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

list

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

patch

 تعديل فئة تذاكر حضور الفعاليات المُشار إليها برقم تعريف الفئة المحدّد

update

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