Kullanmaya başlama
Google Cüzdan API'si nedir?
Google Cüzdan API'si, geliştiricilerin Google Cüzdan'da dijital kart oluşturmalarına olanak tanır. Google Cüzdan API'si şu anda biniş kartlarını, etkinlik biletlerini, bağlılık kartlarını, teklifleri ve toplu taşıma kartlarını desteklemektedir. Kısa süre önce, ek kullanım alanlarını desteklemek için genel bir kart türü eklendi.
API İstisnaları ve Sorun Giderme
- Bu İstisna ne anlama geliyor?
-
Google Cüzdan API'siyle çalışırken API istisnalarıyla karşılaşırsanız açıklamaları ve önerileri aşağıdaki tabloda bulabilirsiniz:
İstisna Örnek Mesaj Öneri 400 - Hatalı İstek İstisnası İstek geçersiz bir bağımsız değişken içeriyor. Geçersiz kaynak kimliği: {1234567891234567899 - ABCD1234567}. Veri yapısının tür, biçim ve uzunluk bilgilerini kontrol edip doğru bağımsız değişkeni iletin. 403 - PermissionDeniedException İzin Reddedildi Doğru Hizmet Hesabı e-postası, Business Pay ve Cüzdan Konsolunuzda yetkili bir kullanıcı olmalıdır. 404 - NotFoundException Cüzdan Nesnesi {1234567891234567899.SampleClubCardxf6a8edf-87ca-4022-a813-694cc57e9fd3} bulunamadı. Güncellenecek bir nesneye sahip olduğunuzdan ve bunun en son halinde olduğundan emin olmak için PATCH veya PUT isteğinden önce denemeden Nesne Kimliği'nde GET işlemi gerçekleştirin. 404 - Düzenleyen Kuruluşu Olmayan NotFoundException Cüzdan Nesnesi Sınıfı {1234567891234567899.ABCD.1234567} bulunamadı. Güncelleme yaparken PATCH veya PUT isteğinden önce GET isteği gönderdiğinizden emin olun. Böylece , dersin en son sınıfa referans vereceğini doğrulayabilirsiniz. Ayrıca istekte doğru yük (nesne ve sınıf) kullanıldığından emin olun. 409 - HalihazırdaVar {1234567891234567899.ABCD.1234567} Cüzdan Nesnesi Sınıfı zaten mevcut. Aynı Sınıf Kimliğini oluşturmaya çalışmadan önce Sınıf Kimliği ile ilgili bir GET işlemi gerçekleştirin. Kaynak mevcutsa PATCH veya PUT kullanabilirsiniz. - Öncelikle, logonuzun yönergelere uygun olduğundan ve PNG biçiminde kaydedildiğinden emin olun.
- Logonun yüksek güvenilirlikle kullanıma hazır olduğundan emin olun. 404 hatalarına neden olabilecek resim dosyalarına yönlendirme yapmayın. Görselleriniz Google Cüzdan'da görünür olmayacağından HTTPS konumunda barındırılmalıdır.
- API'de gerekli olarak işaretlenen tüm zorunlu alanların geçişte ayarlandığından emin olun.
- Bu seçenek, çok sayıda alt işletme/konuya sahip 1 ana hesap kullanan, merkezi olarak yönetilen bir yaklaşım sunar.
- 1 Google Cloud Projesi.
- 1 hizmet hesabı kimlik bilgisi.
- Tek bir kullanıcı grubu.
- Bu seçenek, birçok alt işletme ile tek bir ana hesap kullanan, merkezi olarak yönetilen bir yaklaşımdır.
- 1 Google Cloud Projesi.
- Yayıncıya göre farklı işletme konsolu kullanıcıları.
- 1-çok hizmet hesabı kimlik bilgisi.
- İşletme/konutçu başına 1 kimlik bilgisi.
- İşletme başına farklı kimlik bilgisi erişimi.
- Bu seçenek, birçok alt işletme ile tek bir ana hesap kullanan, merkezi olarak yönetilen bir yaklaşımdır.
- 1 ile birçok Google Cloud Projesi arasında paylaştırın.
- Yayıncıya göre farklı işletme konsolu kullanıcıları.
- 1-çok hizmet hesabı kimlik bilgisi.
- İşletme/ihraç eden başına 1 PROD kimlik bilgisi.
- İşletme/konutçu başına 1 DEV kimlik bilgisi.
Genel Sorular
Push bildirimlerini nasıl etkinleştiririm?
Geliştirici tarafından oluşturulan push bildirimleri şu anda Google Cüzdan tarafından desteklenmemektedir. Ancak Google Cüzdan, aşağıdaki kartlar için zamanında bildirim sağlar. Geliştirici tarafından oluşturulan push bildirimleri şu anda Google Cüzdan tarafından desteklenmemektedir.
| Sektör | Bildirim | Tetiklendi | Belgeler |
|---|---|---|---|
| Etkinlik | Yaklaşan hatırlatıcı | Etkinlikten 3 saat önce | dokümanlar |
| Uçuş kartı | Yaklaşan hatırlatıcı | Uçuş kalkıştan 3 saat önce | dokümanlar |
| Uçuş kartı | Kart Güncellemesi | Kalkış terminali, kapı, biniş saati veya kalkış saati değişikliği | dokümanlar |
| Teklif kartı | Süre sonu hatırlatıcısı | Teklif kartının süresi dolmadan 48 saat önce | dokümanlar |
| Generic | Yaklaşan hatırlatıcı | "Zaman aralığı" başlamadan 24 saat önce | dokümanlar |
| Generic | Süre sonu hatırlatıcısı | "Dahili süre" sona ermeden 48 saat önce | dokümanlar |
Satıcı kimlikleri silinebilir mi?
Satıcı kimlikleri şu anda Google Pay ve Cüzdan Konsolu'ndan silinemiyor veya arşivlenemiyor.
Sınıfları veya nesneleri nasıl silebilirim?
Şu anda sınıfları veya nesneleri Google Cüzdan'dan silemezsiniz. Bununla birlikte, kullanıcılar Google Cüzdan'dan nesnelerin bağlantısını kaldırabilir.
Uygulama bağlama özelliğini nasıl kullanabilirim?
Uygulama bağlama işlemi için buradan izin verilenler listesine eklenmesi gerekebilir.
Zaman ayarım etkinlik için neden yanlış saati gösteriyor?
Kartta gösterilen süre, etkinliğin gerçekleştiği saattir ve etkinliğin gerçekleştiği zaman için farkı gösterilir.
Google Cüzdan coğrafi sınır çizmeyi destekliyor mu?
Coğrafi sınır çizme özelliği şu anda desteklenmemektedir.
Bağlılık programını nasıl oluştururum?
Bu kılavuzu uygulayarak kayıt ve bağlılık programı oluşturabilirsiniz.
Toplu taşıma kartları için Google'a logomu nasıl gönderirim?
İzin verilenler listesine eklenmesi için Google'a logo göndermek istiyorsanız lütfen bu formu kullanın.
Logom, oluşturduğum Kartlara dahil edilmez. Sorun ne olabilir?
JWT'lerin uygulanmasını ve hata ayıklamasını basitleştiren araçlar var mı?
Evet. www.jwt.io gibi platformlar, geliştirme sürecinde jetonlarınızın kodunu çözmenizi ve jetonlarınızı ayıklamanızı sağlayarak, gönderdiğiniz içeriği doğrulamanıza olanak tanır. Google'ın herhangi bir satış ortağı olmadığını ve bu tür üçüncü taraflara özel olarak tavsiye etmediğini unutmayın.
Base64 olarak kodlanmış kullanıcı profili verileri doğru şekilde nasıl işlenir?
Süreç boyunca UTF-8 kodlamasını kullandığınızdan emin olun. JSON dizesi ilk olarak UTF-8 olarak kodlanır, ardından android.util.Base64 kullanılarak NO_WRAP ve URL_Safe seçenekleriyle kodlanır. Bu durum, RFC 3548 bölüm 4'e karşılık gelir.
Birden fazla kartı birlikte nasıl gruplandırırım?
GroupingID, kartları birlikte gruplandırmayı kolaylaştırır.
Düzenleyici hesaplarını nasıl programatik olarak oluşturabilirim?
API aracılığıyla sertifikayı veren hesapları oluşturmak için bu rehberi inceleyin.
JWT bağlantı URL'm 1800 karakter sınırı tarayıcı kısıtlamasını aşıyor. What should I do?
Kartı aktarma bağlantısını (JWT) oluşturmadan önce API'yi kullanarak sınıfları ve nesneleri önceden oluşturabilirsiniz .
Kartın yalnızca bir kısmını nasıl güncelleyebilirim?
PATCH isteklerini kullanarak kısmi güncellemelerin nasıl yapılacağını anlamak için performans kılavuzumuzu takip edin.
Kartlar toplu olarak oluşturulabilir mi?
API'yi kullanarak toplu istek gerçekleştirmeyi öğrenmek için performans kılavuzumuzu takip edin.
Akıllı Dokunma
Google SmartTap kartları için özel bir NFC okuyucuya ihtiyacım var mı?
SmartTap özellikli bir terminal olmalıdır. Sertifikalı sağlayıcıların listesine buradan ulaşabilirsiniz.
Kartlarımın NFC ile çalışmasını nasıl sağlarım?
Kartınızın Akıllı Dokunma'da kullanılabilmesi için lütfen bu yapılandırmayı uygulayın.
Geliştirici kurulumu
Geliştirici ortamımı işletme şartlarıma ve karmaşıklığıma göre nasıl ayarlayabilirim?
Aşağıda, farklı iş düzeylerine ve güvenlik düzeylerine uygun bir geliştirme ortamı oluşturmak için kullanılabilecek kılavuzlar sunulmuştur. Birden fazla hizmet hesabı kullanmak, geliştiricilerin PROD ortamlarından ayrı bir TEST ortamı oluşturmasına olanak tanır.
Temel kurulum karmaşıklığı
Birçok düzenleyen hesaba ait 1 işletme konsolu hesabı veya 1 işletme konsolu üst hesabı.
Ortalama kurulum karmaşıklığı
1 üst hesap (birden çok kartı veren kuruluşa ait hesaplar).
Karmaşık kurulum karmaşıklığı
1 üst hesap (birden çok kartı veren kuruluşa ait hesaplar).
Teknik destek ekibiyle nasıl iletişime geçebilirim?
Daha fazla yardım için Google Pay ve Cüzdan konsolu üzerinden destek ekibiyle iletişime geçin.
Geri bildirim gönder
Ürün hakkında nasıl geri bildirim bırakabilirim?
Ürünle ilgili geri bildirim bırakmak için geliştirici sitesi sayfasının sağ üst çeyreğindeki "Geri Bildirim Gönder" düğmesini tıklayın ve "Ürün geri bildirimi"ni seçin. Ardından, metin alanına geri bildiriminizi açıklayın ve "Gönder"i tıklayın.
Dokümanlarla ilgili nasıl geri bildirim verebilirim?
Dokümanlarla ilgili geri bildirim bırakmak için geliştirici sitesi sayfasının sağ üst çeyreğinde yer alan "Geri Bildirim Gönder" düğmesini tıklayın ve "Belgelerle ilgili geri bildirim"i seçin. Ardından, geri bildiriminizi metin alanında açıklayın ve "Gönder"i tıklayın.