المفاهيم والمصطلحات الرئيسية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
جهة إصدار البطاقة
جهة إصدار البطاقات هي الكيان الذي يملك البطاقة وتقع على عاتقه مسؤولية
إصدار البطاقات للركاب. قد يكون هذا أنت أو المطوّر أو
المؤسسة التي تمثّلها.
لتصبح جهة إصدار البطاقات، عليك التسجيل أولاً بصفة "جهة إصدار".
فئة بطاقة صعود الطائرة
يمكن اعتبار الرحلة الجوية FlightClass كرحلة جوية مجدولة. يمكن لجهة إصدار البطاقة إنشاء عدة رحلات مجدولة مع تبديل المسارات والتوقيتات. ويمكن أن تحتوي كل
رحلة FlightClass تمثِّل رحلة مُجدوَلة على
مظهرها وحقول بياناتها الخاصة لاستيفاء المتطلبات الخاصة بالمطار.
بالإضافة إلى ذلك، يمكن استخدام FlightClass لتفعيل ميزات إضافية، مثل "الدفع الذكي".
عنصر بطاقة الصعود إلى الطائرة
عنصر "بطاقة الصعود إلى الطائرة" هو مثيل لفئة بطاقة الصعود على متن الطائرة. يجب إنشاء مثيل FlightObject جديد لكل راكب يتم توزيعه من خلال "بطاقة صعود الطائرة".
فئة اجتياز الاختبار
فئة بطاقة الصعود إلى الطائرة هي نوع من فئات بطاقات المرور. تصف فئات البطاقات معلومات عامة حول عناصر البطاقات ذات الصلة (مثل الأسلوب والمظهر)، ولا تشمل تفاصيل الركاب.
تشمل الأنواع الأخرى من فئات البطاقات ما يلي:
- بطاقات الولاء
- Event tickets
- بطاقات الهدايا
- عروض
- بطاقات النقل العام
- بطاقات فيروس كورونا المستجد (كوفيد-19)
عنصر التمرير
FlightObject هو نوع من كائنات التمرير. مثل FlightObject، كائن المرور هو مثيل لفئة بطاقة مقابلة. يجب إنشاء عنصر بطاقة لكل راكب أصدر
بطاقة صعود الطائرة.
تحتوي عناصر المرور على معلومات خاصة بالراكب. على سبيل المثال، يمكن استخدامها لتحديد أنّ الراكب ليس لديه تذكرة لرحلة فحسب، بل يمكن أيضًا تحديد المقعد المخصص له.
حساب الخدمة
حساب الخدمة هو الهوية التي يتم استخدامها لطلب 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\u003eBoarding Passes are digital representations of flight tickets, containing passenger and flight-specific information like seat assignments and flight details, issued by registered entities called Issuers.\u003c/p\u003e\n"],["\u003cp\u003eIssuers create Boarding Pass Classes to define the general style, appearance, and data fields for a specific flight or route, like a template for individual Boarding Passes.\u003c/p\u003e\n"],["\u003cp\u003eA new Boarding Pass Object (an instance of a Boarding Pass Class) is generated for each passenger, holding their unique information within the framework of the Boarding Pass Class.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Wallet API integration requires a Service Account, an identity with granted access to the API, and a secure Service Account Key for authentication.\u003c/p\u003e\n"],["\u003cp\u003eBoarding Passes are part of a broader system of digital passes within Google Wallet, encompassing other types such as loyalty cards, event tickets, and gift cards.\u003c/p\u003e\n"]]],["A Pass Issuer, which could be a developer or organization, must register to issue passes. They create `FlightClasses` (scheduled flights) that define appearance and data. For each passenger, a `FlightObject` (instance of the `FlightClass`) is created, containing passenger-specific information. A `Pass Class` defines general pass details, while other pass types include loyalty cards and gift cards. A service account and its key are required for accessing the Google Wallet API. The key must be kept private.\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\nissuing passes to their passengers. This could be you, the developer, or the\norganization that you represent.\n\nIn order to become a passes issuer, you must first register as an Issuer.\n\nBoarding Pass class\n-------------------\n\nA `FlightClass` can be thought of as scheduled flight. An issuer can\ncreate multiple scheduled flights with permutation of routes and timings. Each\n`FlightClass` representing a scheduled flight can contain its own\nappearance and data fields to meet the airport-specific requirements.\n\nIn addition, a `FlightClass` can also be used to enable additional\nfeatures like Smart Tap.\n\nBoarding Pass object\n--------------------\n\nA Boarding Pass object is an instance of a Boarding Pass class. A new\n`FlightObject` instance needs to be created for each passenger that's\ndistributed with a Boarding Pass.\n\nPass Class\n----------\n\nA Boarding Pass 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 passenger details.\n\nOther types of pass classes include the following:\n\n- Loyalty cards\n- Event tickets\n- Gift cards\n- Offers\n- Transit passes\n- COVID cards\n\nPass Object\n-----------\n\nA `FlightObject` is a type of pass object. Like a\n`FlightObject`, a Pass Object is an instance of a corresponding pass\nClass. A pass object needs to be created for each passenger that's issued a\nBoarding Pass.\n\nPass objects contain passenger-specific information. For example, they can be\nused to identify that a passenger 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.\nPermission to access the Google Wallet API needs to be granted to this service\naccount.\n\nService account key\n-------------------\n\nThe service account key is the credential used to authenticate your\napplication as the service account. The service account key is highly sensitive\nand needs to be kept private. If a third party has access to the service account\nkey, they can identify themselves as the service account and perform actions\nthat the service account is permitted to perform."]]
