تجميع بطاقات متعدّدة

استخدام رقم تعريف مجموعة

بشكل تلقائي، لن تؤدي إضافة عدة بطاقات إلى رابط الإضافة إلى "محفظة 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",
  },
}