المفاهيم والمصطلحات الرئيسية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
جهة إصدار البطاقة
جهة إصدار "البطاقات" هي الكيان الذي يملك البطاقة وتقع على عاتقه مسؤولية إصدار البطاقات لعملائه. قد تكون أنت أو المطور أو المؤسسة التي تمثلها.
لتصبح جهة إصدار البطاقات، عليك أولاً التسجيل بصفتك جهة إصدار للبطاقات.
فئة تذكرة حضور الفعالية
يمكن اعتبار EventClass حدثًا مجدولاً. يمكن لجهة الإصدار إنشاء أحداث مجدوَلة متعددة مع تبديل أسماء الأحداث وتوقيتاتها.
يمكن أن يتضمّن كل EventClass يمثّل حدثًا مجدوَلاً حقول البيانات والمظهر الخاص به لاستيفاء المتطلبات الخاصة بالمكان.
بالإضافة إلى ذلك، يمكن أيضًا استخدام "EventClass" لتفعيل ميزات إضافية، مثل "الدفع الذكي".
عنصر تذكرة حضور الفعالية
كائن تذكرة الحدث هو مثال على EventClass. يجب إنشاء مثيل EventObject جديد لكل عميل
يتم توزيعه مع تذكرة فعالية.
فئة اجتياز الاختبار
EventClass هو نوع من Pass Class. تصف "فئات المرور" معلومات عامة حول عناصر المرور ذات الصلة (مثل النمط والمظهر)، ولا تتضمّن تفاصيل العميل.
عنصر التمرير
EventObject هو نوع من كائن المرور. مثل EventObjects، يكون كائن المرور مثيلاً لفئة Pass
مقابلة. يجب إنشاء عنصر مرور لكل عميل يتم إصدار تذكرة حدث له.
تحتوي كائنات المرور على معلومات خاصة بالعميل. على سبيل المثال، يمكن استخدامها لتحديد أنّ العميل لا يملك تذكرة لحضور فعالية فحسب، بل يمكن أيضًا استخدامه لتحديد المقعد الذي تم تخصيصه له.
حساب الخدمة
حساب الخدمة هو الهوية التي تُستخدَم لطلب Google Wallet API. يجب منح إذن الوصول إلى Pass API
لحساب الخدمة هذا.
مفتاح حساب الخدمة
مفتاح حساب الخدمة هو بيانات الاعتماد المستخدَمة لمصادقة تطبيقك باعتباره حساب الخدمة. يجب اعتبار مفتاح حساب الخدمة حساسًا للغاية والحفاظ على خصوصيته. إذا كان بإمكان طرف ثالث الوصول إلى مفتاح حساب الخدمة، سيكون بإمكانه تعريفه بصفته حساب الخدمة وتنفيذ الإجراءات التي يُسمح لحساب الخدمة بتنفيذها.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Passes issuer is the entity responsible for creating and distributing passes to customers, requiring prior registration.\u003c/p\u003e\n"],["\u003cp\u003eEvent Ticket Classes represent scheduled events, enabling customization for venue needs and features like Smart Tap.\u003c/p\u003e\n"],["\u003cp\u003eEvent Ticket Objects are individual instances of Event Ticket Classes, issued to each customer with specific ticket details.\u003c/p\u003e\n"],["\u003cp\u003ePass Objects and Classes function similarly, with Objects storing customer-specific information like seat assignments.\u003c/p\u003e\n"],["\u003cp\u003eA Service Account and its Key are essential for authenticating your application with the Google Wallet API and should be kept secure.\u003c/p\u003e\n"]]],["An Issuer, after registering, creates `EventClass` instances for scheduled events, defining their appearance and data. For each customer, an `EventObject` is generated as an instance of the `EventClass`, containing customer-specific details like seat allocation. `EventClass` is a type of Pass Class, and `EventObject` a Pass Object. A service account, granted access to the Passes API, is used to call the API, and a sensitive service account key authenticates applications as the service account.\n"],null,["# Key concepts and terminology\n\nPass Issuer\n-----------\n\nThe Passes issuer is the entity that owns the pass and is responsible for issuing passes to their customers. This could\nbe you, the developer, or the organization that you represent.\n\nIn order to become a Passes Issuer, you must first register as an Issuer.\n\nevent ticket class\n------------------\n\nA `EventClass` can be thought of as scheduled event. An issuer may create multiple scheduled events with permutation of event names and timings.\nEach `EventClass` representing a scheduled event may contain its own appearance and data fields to meet the venue-specific requirements.\n\nIn addition, `EventClass` can also be used to enable additional features like Smart Tap.\n\nevent ticket object\n-------------------\n\nA event ticket object is an instance of a `EventClass`. A new `EventObject` instance should be created for each customer\nthat is distributed with a event ticket.\n\nPass Class\n----------\n\nA `EventClass` is a type of Pass Class. Pass Classes describe general information for related Pass Objects (such as\nstyle and appearance), and do not include customer details.\n\nPass Object\n-----------\n\nA `EventObject` is a type of Pass Object. Like `EventObjects`, a Pass Object is an instance of a corresponding Pass\nClass. A Pass Object should be created for each customer that is issued a event ticket.\n\nPass Objects contains customer-specific information. For example, it can be used to identify that a customer not only\nhas a ticket for a event, but also identify which seat on the event they've been allotted.\n\nService account\n---------------\n\nThe service account is the identity that is used to call the Google Wallet API. Permission to access the Passes API should be\ngranted to this service account.\n\nService account key\n-------------------\n\nThe service account key is the credential used to authenticate your application as the service account. The service\naccount key should be considered highly sensitive and kept private. If a third party has access to the service account\nkey, they will be able to identify themselves as the service account and perform actions that the service account is\npermitted to perform."]]
