Arka plan
Otomatik Bağlı Kartlar özelliği, mevcut kartınız Google Cüzdan'da zaten kayıtlıysa Ayrıca transkriptinizi Ön bağlantı, kullanıcı birincil kartı kaydettiğinde birincil karta iletilir (ana) kart. Otomatik bağlı kart, birincil kartla birlikte gruplandırılır. birincil kartın üst kısmındaki kullanıcıya yeni bir kartın kullanıldığını bildiren açıklama bağlandı. 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 kartın eklendiğini belirten açıklamanın yer aldığı birincil kart | Birincil karta bağlandı yeni kart |
Kullanım Alanları
Kartları mevcut bir karta bağlamak için farklı kullanım alanlarınız olabilir. Biraz Örnek olarak şunlar verilebilir:
- 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 Bağlı Kartları kullanırken dikkat edilmesi gereken bazı noktalar
- Birincil nesne ve bağlı nesne, aynı DatastoreId değerini kullanmalıdır.
- Birincil nesne başına 50 bağlı nesne sınırı vardır.
- Bağlı kartların otomatik olarak aktarılması garanti edilmez ve hesaba katılmaz gayret gösterin. Kullanıcılar, otomatik bağlı kartları almayı devre dışı bırakabilir. Kullanım alanı kritik öneme sahip olduğundan ve kullanıcının bağlantılı kartı alması gerektiğinden, Kullanıcının kartı eklediğinden emin olmak için başka bir kanal üzerinden iletişim kurma.
- Google Cüzdan AUP ile ilgili güncellemeler otomatik bağlı kartların kullanımıyla ilgili olarak uyulması gereken yönergeleri içermelidir.
Entegrasyon Adımları
Zaten birincil nesne oluşturduysanız 1. adımı atlayabilirsiniz.
- Listelenen herhangi bir kart türünde bir nesne oluşturun yerine gerekli parametrelerle girin. Bu, birincil nesnedir.
- Listelenen herhangi bir kart türünde başka bir nesne oluşturun. Bu, bağlı nesne olarak işaretleyin.
- Birincil nesne kaydedilmeden önce veya kaydedildikten sonra güncelleyin linkedObjectIds içindeki bağlı nesnenin kimliğine sahip birincil nesne parametresinden sonra bir değer girin.
Birincil pas kullanabilir. Zorunlu 3 parametre şunlardır:
- ISSUERID.PRIMARY_OBJECT_ID
- ISSUERID.PRIMARY_CLASS_ID
- ISSUERID.LINKED_OBJECT_ID
Geçiş nesnesine bağlı bir nesne eklemeye yönelik örnek JSON İsteğ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 kartın yüklü olduğu cihazlar bağlı kartı alması gerekir. Bu bağlı kart, birincil kart. Kullanıcılar sağa kaydırarak bağlı kartı görebilir.
İstisna işleme
API'nin yanlış kullanılması, olası hatalara neden olabilir. şunları içerir:
Mesaj | Neden |
---|---|
Birincil nesne ve bağlı nesne aynı vereni paylaşmıyor Kimlik. | Başka bir verenin nesnesine bağlı nesne ekleyemezsiniz. |
Birincil nesne ve bağlı nesne aynı nesneye başvuruda bulunuyor. | linkedObject ile aynı nesneyi ekleyemezsiniz. |
Bağlı nesne mevcut değil. | Bağlı nesne Cüzdan'a zaten eklenmiş olmalıdır API'ye gidin. |
Bağlı nesnenin zaten başka bir bağlı nesnesi var. İç içe eklenemez sağlar. | Bağlı nesnelerin başka bir bağlı nesnesi olamaz. |
Nesne zaten başka bir nesneye bağlı. İç içe yerleştirilmiş bağlantı eklenemez nesneler'i tıklayın. | Birincil nesne, kendi başına bağlı nesne olamaz. |
Daha fazla bağlı nesne eklenemiyor, sınır aşıldı. | Birincil için 50 bağlı kart sınırına ulaşıldı pas kullanabilir. |