تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
استخدام معرّف مجموعة
إضافة بطاقات متعددة إلى بطاقة واحدة بشكل تلقائي
لن يؤدي الرابط الإضافة إلى "محفظة Google" إلى تجميع هذه البطاقات في
تطبيق "محفظة Google" لدى المستخدم. ومع ذلك، يمكن تجميع البطاقات من خلال إنشاء
للتأكد من أن جميعها لديهم نفس معرّف التجميع. ستظهر البطاقات المجمّعة معًا.
في تطبيق "محفظة Google". عند اختيار مجموعة من البطاقات، ستظهر
ستظهر على لوحة عرض دوّارة.
لإضافة بطاقة إلى مجموعة، تكون السمة groupingInfo.groupingId في
يجب تعيين كائن المرور. تمرير جميع العناصر باستخدام
سيتم تجميع قيمة groupingId تلقائيًا معًا، حتى إذا
تم إضافتها بشكل منفصل.
يوضّح المثال التالي بطاقة ولاء وعرضًا يتم جمعهما معًا من أجل
وتحث المستخدم على الاستفادة من كليهما في عملية الشراء التالية.
في بعض الأحيان، يتم استخدام بطاقات صعود الطائرة ضمن مجموعة وليس بشكل فردي. من الشائع
هو تجميع تذاكر الرحلات الجوية مع محطات توقف أو متعددة
التوقف.
تتضمّن بطاقات صعود الطائرة منطقًا إضافيًا يجمع البطاقات تلقائيًا.
معًا إذا كانت لها القيم نفسها للسمات التالية:
FlightClass.flightHeader.carrier.carrierIataCode
FlightClass.flightHeader.flightNumber
FlightClass.localScheduledDepartureDateTime
FlightObject.reservationInfo.confirmationCode
الجزء الخاص برقم تعريف جهة الإصدار من "FlightObject.id"
في حال اختلاف أي من الخصائص المذكورة أعلاه عن بطاقتَي صعود الطائرة، فيتم استخدامهما.
غير مجمّعة (ما لم يتم استخدام السمة groupingInfo) كما ترى، يقدر كلا الصفين
وخصائص الكائن على التجميع التلقائي. يتيح هذا الإجراء استخدام بطاقات صعود الطائرة.
فئات مختلفة ليتم تجميعها معًا (على سبيل المثال عندما تكون هناك رحلات جوية مختلفة
في نفس الرحلة لديها شركات تشغيل مختلفة).
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eMultiple passes added to a single Google Wallet link can be grouped together using the same \u003ccode\u003egroupingId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eGrouped passes are displayed together in the Google Wallet app and can be provisioned together or grouped later via update/patch methods.\u003c/p\u003e\n"],["\u003cp\u003eBoarding passes have automatic grouping logic based on shared flight details, but using the \u003ccode\u003egroupingInfo\u003c/code\u003e property overrides this automatic grouping.\u003c/p\u003e\n"]]],["Passes in Google Wallet can be grouped by assigning them a shared `groupingId` property, ensuring they appear together in the app. This grouping can occur during the initial provisioning or via `update` or `patch` methods. Boarding passes also have automatic grouping based on properties like carrier code, flight number, departure time, and confirmation code. Setting a `groupingInfo` overrides this automatic logic. A loyalty card and offer could be grouped using the same `groupingId`.\n"],null,["# Group multiple Boarding passes\n\nUse a grouping ID\n-----------------\n\n\nBy default, adding multiple passes to a single\n**Add to Google Wallet** link will not group those passes in the\nuser's Google Wallet app. However, passes can be grouped together by making\nsure they all have the same grouping ID. Grouped passes will appear together\nin the Google Wallet app. When a group of passes is selected, each pass will\nbe shown on a carousel.\n\nPasses can be grouped together:\n\n- During initial provisioning\n- By using the [`update`](/wallet/tickets/boarding-passes/rest/v1/flightobject/update) or [`patch`](/wallet/tickets/boarding-passes/rest/v1/flightobject/patch) methods\n\n\nTo add a pass to a group, the `groupingInfo.groupingId` property of\nthe pass object must be set. All pass objects with the same\n`groupingId` value will be automatically grouped together, even if\nthey were added separately.\n\n\nThe following example shows a loyalty card and offer being grouped together to\nentice the user to make use of both in their next purchase. \n\n```carbon\nloyaltyObject = {\n \"classId\": \"ISSUER_ID.GIFT_CARD_CLASS_SUFFIX\",\n \"id\": \"ISSUER_ID.GIFT_CARD_OBJECT_SUFFIX\",\n \"state\": \"ACTIVE\",\n \"groupingInfo\": {\n # Note the same groupingId value\n \"groupingId\": \"combinedGiftCardAndOfferId\",\n \"sortIndex\": 1\n },\n \"barcode\": {\n \"type\": \"QR_CODE\",\n \"value\": \"QR code\"\n },\n \"accountId\": \"Account id\",\n \"accountName\": \"Account name\",\n \"loyaltyPoints\": {\n \"label\": \"Points\",\n \"balance\": {\n \"int\": 800\n }\n }\n}\n\nofferObject = {\n \"classId\": \"ISSUER_ID.OFFER_CLASS_SUFFIX\",\n \"id\": \"ISSUER_ID.OFFER_OBJECT_SUFFIX\",\n \"state\": \"ACTIVE\",\n \"groupingInfo\": {\n # Note the same groupingId value\n \"groupingId\": \"combinedGiftCardAndOfferId\",\n \"sortIndex\": 2\n },\n \"barcode\": {\n \"type\": \"QR_CODE\",\n \"value\": \"QR code\",\n },\n}\n```\n\nBoarding pass automatic grouping\n--------------------------------\n\n| **Note:** The `groupingInfo` property of a pass will always take precedence over the automatic grouping logic used by Boarding passes.\n\nSometimes boarding passes are used in a group rather than individually. A common\nscenario for this is grouping of tickets for flights with layovers or multiple\nstops.\n\nBoarding passes have additional logic that will automatically group passes\ntogether if they have the same values for the following properties:\n\n- `FlightClass.flightHeader.carrier.carrierIataCode`\n- `FlightClass.flightHeader.flightNumber`\n- `FlightClass.localScheduledDepartureDateTime`\n- `FlightObject.reservationInfo.confirmationCode`\n- The Issuer ID portion of `FlightObject.id`\n\nIf any of the above properties are different for two Boarding passes, they are\nnot grouped (unless you do so using `groupingInfo`). As you can see, both class\nand object properties affect automatic grouping. This enables Boarding passes\nof different classes to be grouped together (such as when different flights\nin the same trip have different operating carriers)."]]