تجميع بطاقات متعدّدة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
استخدام معرّف مجموعة
إضافة بطاقات متعددة إلى بطاقة واحدة بشكل تلقائي
لن يؤدي الرابط الإضافة إلى "محفظة Google" إلى تجميع هذه البطاقات في
تطبيق "محفظة Google" لدى المستخدم. ومع ذلك، يمكن تجميع البطاقات من خلال إنشاء
للتأكد من أن جميعها لديهم نفس معرّف التجميع. ستظهر البطاقات المجمّعة معًا.
في تطبيق "محفظة Google". عند اختيار مجموعة من البطاقات، ستظهر
ستظهر على لوحة عرض دوّارة.
يمكن تجميع البطاقات معًا:
- خلال عملية توفير المتطلبات اللازمة
-
من خلال استخدام
update
أو
patch
طرق
لإضافة بطاقة إلى مجموعة، تكون السمة groupingInfo.groupingId في
يجب تعيين كائن المرور. تمرير جميع العناصر باستخدام
سيتم تجميع قيمة groupingId تلقائيًا معًا، حتى إذا
تم إضافتها بشكل منفصل.
يوضّح المثال التالي بطاقة ولاء وعرضًا يتم جمعهما معًا من أجل
وتحث المستخدم على الاستفادة من كليهما في عملية الشراء التالية.
loyaltyObject = {
"classId": "ISSUER_ID.GIFT_CARD_CLASS_SUFFIX",
"id": "ISSUER_ID.GIFT_CARD_OBJECT_SUFFIX",
"state": "ACTIVE",
"groupingInfo": {
# Note the same groupingId value
"groupingId": "combinedGiftCardAndOfferId",
"sortIndex": 1
},
"barcode": {
"type": "QR_CODE",
"value": "QR code"
},
"accountId": "Account id",
"accountName": "Account name",
"loyaltyPoints": {
"label": "Points",
"balance": {
"int": 800
}
}
}
offerObject = {
"classId": "ISSUER_ID.OFFER_CLASS_SUFFIX",
"id": "ISSUER_ID.OFFER_OBJECT_SUFFIX",
"state": "ACTIVE",
"groupingInfo": {
# Note the same groupingId value
"groupingId": "combinedGiftCardAndOfferId",
"sortIndex": 2
},
"barcode": {
"type": "QR_CODE",
"value": "QR code",
},
}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eBy default, multiple passes added to Google Wallet are not grouped; however, you can group them using a \u003ccode\u003egroupingId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eGrouped passes appear together in the Google Wallet app and can be provisioned together or grouped later using the \u003ccode\u003eupdate\u003c/code\u003e or \u003ccode\u003epatch\u003c/code\u003e methods.\u003c/p\u003e\n"],["\u003cp\u003eTo group passes, ensure the \u003ccode\u003egroupingInfo.groupingId\u003c/code\u003e property is the same for all passes you want to group.\u003c/p\u003e\n"],["\u003cp\u003eSetting the same \u003ccode\u003egroupingId\u003c/code\u003e for different pass types like loyalty cards and offers allows you to create combined experiences for users.\u003c/p\u003e\n"]]],["Passes in Google Wallet can be grouped by assigning them a shared `groupingId`. This can be done during the initial provisioning or later using `update` or `patch` methods. Setting the `groupingInfo.groupingId` property in each pass object ensures they are grouped. Passes with the same `groupingId` appear together in the user's wallet and are shown on a carousel when selected. The example shows a loyalty card and an offer using \"combinedGiftCardAndOfferId\" to be grouped.\n"],null,["# Group multiple 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/transit-passes/qr-code/rest/v1/transitobject/update) or [`patch`](/wallet/tickets/transit-passes/qr-code/rest/v1/transitobject/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```"]]
