Biniş kartlarını otomatik olarak ekleme

Arka plan

Bu özellik, havayollarının biniş kartlarını kullanıcının Google Cüzdan'ına otomatik olarak göndermesine olanak tanır. Bu özellik, özellikle sık seyahat edenlere fayda sağlayacak. Bu kullanıcılar, seyahat sıklıkları daha yüksek olduğundan biniş kartlarını Cüzdan'a daha kolay ve sorunsuz bir şekilde ekleyebilecek.

Bu işlem, check-in kanalından (ör. web, uygulama veya havaalanı kiosk'u) bağımsız olarak otomatik olarak gerçekleşir. Hava yolu, kartı ilişkilendirmek ve göndermek için kullanıcının bağlılık programı hesap numarasını kullanır.

Not: Bu özellik, "Otomatik Bağlı Kartlar" özelliğinin belirli bir uygulamasıdır. Belgenin geri kalanında bu işlevi tanımlamak için "Otomatik Bağlantılı Kartlar" ve "birincil kart" ile "bağlantılı kart" gibi daha geniş kapsamlı terimler kullanılmaktadır.

Bu özellik nasıl çalışır?

1. adım: Sık seyahat eden kullanıcının bağlılık kartını Cüzdan'a eklemesine izin verin.

2. adım: Sık uçan yolcuya ait yeni biniş kartlarını, Cüzdan'daki bağlılık kartına bağlayarak otomatik olarak ekleyin.

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 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: