Otomatik Olarak Bağlanan Kartlar

Arka plan

Otomatik Bağlı Kartlar özelliği, mevcut kartınızı Google Cüzdan'ında bulunduran bir kullanıcıya ek kartlar göndermenize olanak tanır. Kullanıcı birincil (ana) geçişi kaydettiğinde geçişleri önceden birincil geçişe bağlayabilirsiniz. Otomatik olarak bağlanan kart, birincil kartla gruplandırılır. Birincil kartın üzerinde, kullanıcıyı yeni bir kartın bağlandığı konusunda bilgilendiren bir açıklama metni bulunur. Aşağıdaki geçiş türleri birincil veya bağlı geçiş 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ğlama
• Yemek kuponu bir biniş kartına veya etkinlik biletine bağlanabilir.
• Bir etkinlik biletine park kartını bağlayabilirsiniz.

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

• Birincil nesne ve bağlı nesne aynı issuerId değerini 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 mümkün olduğunca gönderildiği 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ı geçişi alması gerekiyorsa kullanıcının geçişi eklediğinden emin olmak için başka bir kanal üzerinden iletişime geçmenizi öneririz.
• Google Cüzdan HUP'de yapılan güncellemeler, Otomatik Bağlı Kartların kullanımıyla ilgili uyulması gereken yönergeleri içerir.

Entegrasyon Adımları

Daha önce 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 geçiş türünde başka bir nesne oluşturun. Bu, bağlı nesne olacaktır.
3. Birincil nesne kaydedilmeden önce veya sonra, birincil nesneyi linkedObjectIds parametresindeki bağlı nesnenin kimliğiyle güncelleyin.

Birincil geçişte linkedObjectIds'i ayarlamak için minimum bir yük verisi gerekir. Zorunlu 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 isteğ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 sonra ö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 geçişin bulunduğu cihazlar bağlı geçişi alır. Bu bağlı geçiş, birincil geçişle 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 şunlardır:

Mesaj	Nedeni
Birincil nesne ve bağlı nesne aynı veren kimliğini paylaşmıyor.	Bağlı bir nesneyi başka bir verenin nesnesine ekleyemezsiniz.
Birincil nesne ve bağlı nesne aynı nesneyi ifade eder.	linkedObject ile aynı nesneyi ekleyemezsiniz.
Bağlı nesne mevcut değil.	Bağlı nesne, Cüzdan API'sine zaten eklenmiş olmalıdır.
Bağlı nesnenin zaten başka bir bağlı nesnesi var. İç içe yerleştirilmiş bağlı nesneler eklenemez.	Bağlı nesnelerin başka bir bağlı nesnesi olamaz.
Nesne zaten başka bir nesneye bağlı. İç içe yerleştirilmiş bağlı nesneler eklenemez.	Birincil nesne kendi başına bağlı bir nesne olamaz.
Sınır aşıldığı için daha fazla bağlı nesne eklenemiyor.	Birincil kart için 50 bağlı kart sınırına ulaşıldı.