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, 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 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. Bu tür içeriğe ilişkin bazı örnekler:

• 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 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 KTS'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 geçişte 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 şunlardır:

Mesaj	Neden
Birincil nesne ve bağlı nesne aynı veren kimliğini paylaşmıyor.	Bağlı bir nesneyi başka bir veren kuruluşun nesnesine ekleyemezsiniz.
Birincil nesne ve bağlı nesne aynı nesneyi ifade eder.	Aynı nesneyi linkedObject olarak ekleyemezsiniz.
Bağlı nesne mevcut değil.	Bağlı nesne, Cüzdan API'sine daha önce eklenmiş olmalıdır.
Bağlı nesneye zaten başka bir bağlı nesne eklenmiş. İç içe yerleştirilmiş bağlı nesneler eklenemez.	Bağlı nesneler başka bir bağlı nesneye sahip olamaz.
Nesne zaten başka bir nesneye bağlı. İç içe yerleştirilmiş bağlı nesneler eklenemez.	Birincil nesne, tek başına bağlı bir nesne olamaz.
Bağlı nesne eklenemiyor, sınır aşıldı.	Birincil kart için 50 bağlantılı kart sınırına ulaşıldı.