Otomatik Olarak Bağlanan Kartlar

Arka plan

Otomatik Bağlantılı Kartlar özelliği, mevcut kartınızı Google Cüzdan'ında bulunduran bir kullanıcıya ek kartlar göndermenizi sağlar. Ayrıca bir kullanıcı birincil (ana) kartı kaydettiğinde kartları birincil karta önceden bağlayabilirsiniz. Otomatik Bağlantılı Kart, birincil kartın üzerinde yer alan ve kullanıcıya yeni bir kartın bağlandığını bildiren bir açıklama metniyle birlikte birincil kartla birlikte gruplandırılır. Birincil veya bağlı kart olarak aşağıdaki kart türleri desteklenir:

  • Etkinlik bileti
  • Uçuş kartı
  • Toplu taşıma kartı
  • Teklif
  • Hediye kartı
  • Bağlılık kartı
  • Genel kart
Otomatik Bağlı Kart Birincil Örneği Otomatik Bağlantılı Kart İkincil Örneği
Yeni bir kart eklendiğini belirten birincil kart Yeni kart, birincil karta bağlı

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.
  • Otopark kartını etkinlik biletine bağlayın.

Otomatik Bağlı Kartları kullanırken dikkat edilmesi gereken bazı noktalar

  • Birincil nesne ve bağlı nesne aynı publishId'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 Bağlantılı Kartlar almayı devre dışı bırakabilir. Kullanım alanı kritik öneme sahipse ve kullanıcının bağlı kartı alması gerekiyorsa kullanıcının kartı eklediğinden emin olmak için başka bir kanal üzerinden iletişim kurmanızı öneririz.
  • Google Cüzdan AUP'deki güncellemeler, Otomatik Bağlantılı Kartların kullanımıyla ilgili uyulması gereken rehberliği içerir.

Entegrasyon Adımları

Zaten birincil bir nesne oluşturduysanız 1. adımı atlayabilirsiniz.

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

Birincil geçiş kartındaki linkedObjectId öğelerini ayarlamak için gereken minimum yük gereklidir. Gerekli olan 3 parametre şunlardır:

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

Geçiş nesnesine bağlı bir nesne eklemek için örnek JSON İsteği

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

Bir nesneyi geçiş nesnesine bağladıktan sonraki 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ı içeren 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ı, aşağıdakileri de kapsayabilir:

Mesaj Neden
Birincil nesne ve bağlı nesne aynı yayıncı kimliğini paylaşmıyor. Başka bir yayıncının nesnesine bağlı bir nesne ekleyemezsiniz.
Birincil nesne ve bağlı nesne aynı nesneye başvuruyor. linkedObject ile aynı nesneyi ekleyemezsiniz.
Bağlı nesne mevcut değil. Bağlı nesnenin Cüzdan API'sine önceden eklenmiş olması gerekir.
Bağlı nesne zaten başka bir bağlı nesneye sahip. İç içe bağlı nesneler eklenemez. Bağlı nesnelerin başka bir bağlı nesnesi olamaz.
Nesne zaten başka bir nesneye bağlı. İç içe bağlı nesneler eklenemez. Birincil nesne, tek başına bağlı bir nesne olamaz.
Sınır aşıldığı için daha fazla bağlı nesne eklenemiyor. Birincil geçiş kartı için 50 adet bağlı kart sınırına ulaşıldı.