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 eklemek için daha basit ve sorunsuz bir yöntemden yararlanacak.

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 iş ortakları, kullanıcının bağlılık programı hesap numarasını kullanarak kartı 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ın 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 şekilde bağlılık programına kaydolmayı 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ı) havayolu şirketinizin 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ılı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 gösterilerek yapılır. 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 KAK'da yapılan güncellemeler, Otomatik Bağlı 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 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ğine sahip değil.	Bağlı bir nesneyi başka bir sağlayıcının 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ı nesne zaten başka bir bağlı nesneye sahip. İç 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.