المفاهيم والمصطلحات الرئيسية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
جهة إصدار البطاقة
تملك جهة إصدار "البطاقات" البطاقة وعليك إصدارها لعملائها. قد تكون أنت أو المطور أو المؤسسة التي تمثلها.
لتصبح جهة إصدار البطاقات، عليك أولاً التسجيل بصفتك جهة إصدار للبطاقات.
فئة الولاء
يمكن اعتبار فئة الولاء برنامج ولاء. ويمكن لجهة إصدار البطاقة إنشاء عدة برامج ولاء، مثل Standard وPremium، ولكل منهما أسلوبه ومظهره المميزين.
بالإضافة إلى النمط والمظهر، يمكن استخدام فئات الولاء أيضًا لتفعيل ميزات إضافية مثل "الدفع الذكي" و"التسجيل" و"تسجيل الدخول".
عنصر الولاء
عنصر الولاء هو مثال على فئة الولاء. أنشئ مثيلاً جديدًا لكائن برنامج الولاء
لكل عميل مسجل في برنامج ولاء.
فئة اجتياز الاختبار
فئة الولاء هي نوع من فئة البطاقة. تصف "فئات المرور" معلومات عامة تتعلّق بكائنات المرور ذات الصلة، مثل النمط والمظهر، ولا تتضمّن تفاصيل العميل.
تشمل الأنواع الأخرى من فصول Pass ما يلي:
- جواز المرور على متن الطائرة
- Event tickets
- بطاقات الهدايا
- عروض
- بطاقات النقل العام
- بطاقات التلقيح
عنصر التمرير
كائن الولاء هو نوع من كائن المرور. مثل كائنات الولاء، كائن المرور
هو مثيل لفئة بطاقة مقابلة. أنشئ عنصر تمرير
لكل عميل يتم إصدار تصريح له.
تحتوي كائنات المرور على معلومات خاصة بالعميل. على سبيل المثال، يمكن استخدام هذه المعلومات
لمعرفة أنّ العميل لا يملك تذكرة لرحلة فحسب، ولكن أيضًا لتحديد المقعد الذي تم تخصيصه له.
حساب الخدمة
حساب الخدمة هو الهوية التي يتم استخدامها لطلب Google Wallet API.
احرص على منح حساب الخدمة هذا الإذن بالوصول إلى Google Wallet API.
مفتاح حساب الخدمة
مفتاح حساب الخدمة هو بيانات الاعتماد المستخدَمة لمصادقة تطبيقك
بصفته حساب الخدمة. يُعد مفتاح حساب الخدمة حساسًا للغاية
ويجب أن يبقى خاصًا. إذا كان لدى طرف ثالث إذن الوصول إلى مفتاح حساب الخدمة،
يمكنه التعريف عن نفسه كحساب الخدمة وتنفيذ
الإجراءات التي يُسمح لحساب الخدمة بتنفيذها.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe pass issuer, who can be you or your organization, must register and issue passes to customers.\u003c/p\u003e\n"],["\u003cp\u003eLoyalty programs are represented by Loyalty Classes, which define style, appearance, and features like Smart Tap.\u003c/p\u003e\n"],["\u003cp\u003eA Loyalty Object is created for each customer enrolled in a loyalty program, and it's an instance of a Loyalty Class, which is a type of Pass Class.\u003c/p\u003e\n"],["\u003cp\u003ePass Objects store customer-specific information and are instances of Pass Classes, which can represent various types like boarding passes, event tickets, and gift cards.\u003c/p\u003e\n"],["\u003cp\u003eA service account with a securely stored key is used to authenticate your application with the Google Wallet API.\u003c/p\u003e\n"]]],["Passes issuers register to create loyalty programs (Loyalty Classes) with unique styles and features. Each customer enrolled gets a Loyalty Object, an instance of the Loyalty Class. Pass Classes, including Loyalty Classes, define general pass details. Each customer receives a Pass Object, an instance of a Pass Class, containing customer-specific information. A service account accesses the Google Wallet API, authenticated by a private service account key.\n"],null,["# Key concepts and terminology\n\nPass issuer\n-----------\n\nThe Passes issuer owns the pass and must issue passes to their customers. This\ncan be 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\nLoyalty Class\n-------------\n\nA Loyalty Class can be thought of as loyalty program. An issuer might create\nmultiple loyalty programs like *Standard* and *Premium*, each with their own\ndistinctive style and appearance.\n\nIn addition to style and appearance, Loyalty Classes can also be used to enable\nadditional features like Smart Tap, and the Enrollment and Sign In.\n\nLoyalty Object\n--------------\n\nA Loyalty Object is an instance of a Loyalty Class. Create a new Loyalty Object\ninstance for each customer that's enrolled in a loyalty program.\n\nPass Class\n----------\n\nA Loyalty Class is a type of Pass Class. Pass Classes describe general\ninformation for related Pass Objects such as style and appearance, and don't\ninclude customer details.\n\nOther types of Pass Classes include:\n\n- Boarding pass\n- Event tickets\n- Gift cards\n- Offers\n- Transit passes\n- Vaccine cards\n\nPass Object\n-----------\n\nA Loyalty Object is a type of Pass Object. Like Loyalty Objects, a Pass Object\nis an instance of a corresponding Pass Class. Create a Pass Object\nfor each customer that's issued a pass.\n\nPass Objects contains customer-specific information. For example, it can be used\nto identify that a customer not only has a ticket for a flight, but also\nidentify which seat on the flight they've been allotted.\n\nService account\n---------------\n\nThe service account is the identity that's used to call the Google Wallet API.\nBe sure to grant permission to access the Google Wallet API to this service account.\n\nService account key\n-------------------\n\nThe service account key is the credential used to authenticate your application\nas the service account. The service account key is highly sensitive and\nmust be kept private. If a third party has access to the service account\nkey, they can identify themselves as the service account and perform\nactions that the service account is permitted to perform."]]
