المفاهيم والمصطلحات الرئيسية

جهة إصدار البطاقة

جهة إصدار "البطاقات" هي الكيان الذي يملك البطاقة وتقع على عاتقه مسؤولية إصدار البطاقات لعملائه. قد تكون أنت أو المطور أو المؤسسة التي تمثلها.

لتصبح جهة إصدار البطاقات، عليك أولاً التسجيل بصفتك جهة إصدار للبطاقات.

فئة تذكرة حضور الفعالية

يمكن اعتبار EventClass حدثًا مجدولاً. يمكن لجهة الإصدار إنشاء أحداث مجدوَلة متعددة مع تبديل أسماء الأحداث وتوقيتاتها. يمكن أن يتضمّن كل EventClass يمثّل حدثًا مجدوَلاً حقول البيانات والمظهر الخاص به لاستيفاء المتطلبات الخاصة بالمكان.

بالإضافة إلى ذلك، يمكن أيضًا استخدام "EventClass" لتفعيل ميزات إضافية، مثل "الدفع الذكي".

عنصر تذكرة حضور الفعالية

كائن تذكرة الحدث هو مثال على EventClass. يجب إنشاء مثيل EventObject جديد لكل عميل يتم توزيعه مع تذكرة فعالية.

فئة اجتياز الاختبار

EventClass هو نوع من Pass Class. تصف "فئات المرور" معلومات عامة حول عناصر المرور ذات الصلة (مثل النمط والمظهر)، ولا تتضمّن تفاصيل العميل.

عنصر التمرير

EventObject هو نوع من كائن المرور. مثل EventObjects، يكون كائن المرور مثيلاً لفئة Pass مقابلة. يجب إنشاء عنصر مرور لكل عميل يتم إصدار تذكرة حدث له.

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

حساب الخدمة

حساب الخدمة هو الهوية التي تُستخدَم لطلب Google Wallet API. يجب منح إذن الوصول إلى Pass API لحساب الخدمة هذا.

مفتاح حساب الخدمة

مفتاح حساب الخدمة هو بيانات الاعتماد المستخدَمة لمصادقة تطبيقك باعتباره حساب الخدمة. يجب اعتبار مفتاح حساب الخدمة حساسًا للغاية والحفاظ على خصوصيته. إذا كان بإمكان طرف ثالث الوصول إلى مفتاح حساب الخدمة، سيكون بإمكانه تعريفه بصفته حساب الخدمة وتنفيذ الإجراءات التي يُسمح لحساب الخدمة بتنفيذها.