Biniş kartlarını otomatik olarak ekleme

Arka plan

Bu özellik, havayollarının biniş kartlarını otomatik olarak kullanıcının Google Cüzdan'ına 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. İş ortağı hava yolu şirketleri, kullanıcının bağlılık programı hesap numarasını kullanarak kartı ilişkilendirebilir ve kullanıcının Cüzdan'ına gönderebilir.

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

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

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

En iyi uygulamalar

• Sık uçan yolcular için sorunsuz bir bağlılık programı kaydı sağlamak amacıyla Google ile kaydolma / oturum açma akışını etkinleştirmeyi düşünebilirsiniz. Kullanıcılar, Google Cüzdan'daki çeşitli giriş noktalarında (ör. biniş kartları) havayolunuzun bağlılık programına kayıt akışını keşfedebilir.
• Android uygulamanızda ve web sitenizde mevcut bağlılık programı üyeleri için tek tıklamayla kaydı etkinleştirmeyi düşünebilirsiniz.

Not: Bu özellik, otomatik olarak bağlanan kartlar özelliğinin belirli bir uygulamasıdır. Bu bağlamda birincil kart, bağlılık kartını; bağlı kart ise biniş kartını ifade eder. Bu belgenin geri kalanında, bu işlevi açıklamak için daha geniş bir terminoloji (otomatik olarak bağlanan kartlar, birincil kart ve bağlı kart) kullanılmaktadır.

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

• Birincil nesne ve bağlı nesne aynı issuerId'yi kullanmalıdı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"
  }
  …

İ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.