Otomatik Olarak Bağlanan Kartlar

Arka plan

Otomatik Bağlı Kartlar özelliği, Google Cüzdan'ında mevcut kartınız bulunan bir kullanıcıya ek kartlar göndermenize olanak tanır. Kullanıcı birincil (ana) kartı kaydettiğinde kartları birincil karta önceden bağlayabilirsiniz. Otomatik olarak bağlanan kart, birincil kartla gruplandırılır. Birincil kartın üzerinde, kullanıcıya yeni bir kartın bağlandığını bildiren bir açıklama bulunur. Aşağıdaki kart türleri birincil veya bağlı kart olarak desteklenir:

• Etkinlik bileti
• Uçuş kartı
• Toplu taşıma kartı
• Teklif
• Hediye kartı
• Bağlılık kartı
• Genel kart

Yeni bir kartın eklendiğini belirten açıklama metni içeren birincil kart	Birincil karta bağlı yeni kart

Kullanım Alanları

Kartları mevcut bir karta bağlamak için farklı kullanım alanlarınız olabilir. Buna örnek olarak aşağıdakiler verilebilir:

• Bir teklifi mevcut bir bağlılık kartına bağlayın.
• Yemek kuponunu biniş kartına veya etkinlik biletine bağlayın.
• Park kartını etkinlik biletine bağlayın.

Otomatik olarak bağlanan kartları kullanırken dikkat edilmesi gereken bazı noktalar

• Birincil nesne ve bağlı nesne aynı issuerId'yi kullanmalıdır.
• Birincil nesne başına 50 bağlı nesne sınırı vardır.
• Bağlı kartların otomatik olarak gönderilmesi garanti edilmez ve en iyi çaba olarak kabul edilir. Kullanıcılar, otomatik olarak bağlanan kartları almayı devre dışı bırakabilir. Kullanım alanı kritikse ve kullanıcının bağlı kartı alması gerekiyorsa kullanıcının kartı eklemesini sağlamak için başka bir kanal üzerinden iletişim kurmanızı öneririz.
• Google Cüzdan KDG'deki güncellemeler, otomatik olarak bağlanan kartların kullanımıyla ilgili uyulması gereken yönergeleri içerir.

Entegrasyon adımları

Daha önce bir birincil nesne oluşturduysanız 1. adımı atlayabilirsiniz.

1. Listelenen herhangi bir kart türünde, gerekli parametreleri içeren bir nesne oluşturun. Bu, birincil nesnedir.
2. Listelenen herhangi bir kart türünde başka bir nesne oluşturun. Bu, bağlı nesne olacaktır.
3. Birincil nesne kaydedilmeden önce veya sonra, linkedObjectIds parametresindeki bağlı nesnenin kimliğiyle birincil nesneyi güncelleyin.

Birincil kartta linkedObjectIds ayarlanması için minimum yük boyutu gerekir. Gerekli 3 parametre şunlardır:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

Bağlı bir nesneyi kart nesnesine eklemek için örnek JSON isteği

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

Bir nesneyi kart nesnesine bağladıktan sonraki örnek JSON yanıtı

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Beklenen davranış

Başarılı bir yanıt aldıktan sonra, güncellediğiniz kartın bulunduğu cihazlar bağlı kartı alır. Bu bağlı kart, birincil kartla birlikte gruplandırılır. Kullanıcılar, sağa kaydırarak bağlı kartı görebilir.

İstisna işleme

API'nin yanlış kullanımıyla ilgili olası hatalar şunları içerebilir: