Başlarken
Google Cüzdan API'si nedir?
Google Cüzdan API'si, geliştiricilerin Google Cüzdan'da dijital kartlar oluşturması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. Daha yakın zamanda, ek kullanım alanlarını desteklemek için genel bir kart türü eklenmiştir.
Geliştirme ortamımı işletme ihtiyaçlarıma ve karmaşıklığına göre nasıl ayarlayabilirim?
Aşağıda, farklı düzeylerde işletme karmaşıklığı ve güvenliğine uygun bir geliştirme ortamı oluşturmak için kullanılabilecek kılavuzlar verilmiştir. Birden fazla hizmet hesabı kullanmak, geliştiricilerin PROD ortamlarından ayrı bir TEST ortamı oluşturmasını sağlayabilir.
Temel kurulumun karmaşıklığı
Çok sayıda kart veren hesap için 1 Business Console hesabı veya 1 Business Console üst hesabı.
- Bu seçenek, sıfır ila çok sayıda alt işletme/içerik sağlayıcı içeren 1 ana hesap kullanılarak merkezi olarak yönetilen bir yaklaşım sağlar.
- 1 Google Cloud projesi.
- 1 hizmet hesabı kimlik bilgisi.
- Tek bir kullanıcı grubu.
Ortalama kurulum karmaşıklığı
1 üst hesap ile birden fazla kart veren kuruluş hesabına bağlayabilirsiniz.
- Bu seçenek, birçok alt işletme içeren 1 ana hesap kullanılarak merkezi olarak yönetilen bir yaklaşım sağlar.
- 1 Google Cloud projesi.
- Her sağlayıcı için farklı Business Console kullanıcıları.
- 1 ila çok sayıda hizmet hesabı kimlik bilgisi.
- İşletme/içerik sağlayıcı başına 1 kimlik bilgisi.
- İşletmeye göre farklı kimlik bilgisi erişimi.
Karmaşık kurulum karmaşıklığı
1 üst hesaptan çok sayıda veren hesabına.
- Bu seçenek, birçok alt işletme içeren 1 ana hesap kullanılarak merkezi olarak yönetilen bir yaklaşım sağlar.
- 1 ila çok sayıda Google Cloud projesi.
- Her sağlayıcı için farklı Business Console kullanıcıları.
- 1 ila çok sayıda hizmet hesabı kimlik bilgisi.
- İşletme/içerik sağlayıcı başına 1 PROD kimlik bilgisi.
- İşletme/içerik sağlayıcı başına 1 geliştirici kimliği.
Destek ekibiyle iletişime geçin
Kartlarla çalışma
Sınıfları veya nesneleri nasıl silebilirim?
Şu anda Google Cüzdan'dan sınıfları veya nesneleri silemezsiniz. Ancak kullanıcılar Google Cüzdan'larındaki nesnelerin bağlantısını kaldırabilir.
Birden fazla geçişi nasıl gruplandırırım?
GroupingID'yi kullanmak, kartları gruplandırmayı kolaylaştırır.
Bir geçişin yalnızca bir bölümünü nasıl güncelleyebilirim?
PATCH isteklerini kullanarak kısmi güncellemelerin nasıl yapılacağını öğrenmek için performans kılavuzumuzu inceleyin.
Kartları toplu olarak oluşturabilir miyim?
API'yi kullanarak toplu isteklerin nasıl gerçekleştirileceğini anlamak için performans kılavuzumuzu izleyin.
Genel Sorular
Google Cüzdan API'sine gönderilen isteklerin hız sınırı nedir?
Google Cüzdan API'sine yapılan çağrılar saniyede 20 istekle sınırlıdır.
Kişisel resimlerin Google Cüzdan'daki kartlarda kullanılması neden yasaktır?
Mevcut düzenlemeler uyarınca tüm tüketicilerin hassas verilerin toplanmasını veya işlenmesini devre dışı bırakma hakkı olduğundan Google Cüzdan, kartlarda kişisel resimleri desteklemez. Değerli nesnenin (JWT'de) parçası olarak hassas veriler (kişisel resimler) bulunması, verilerin orijinal izin sözleşmesinin dışında herkese açık hale gelmesiyle ilgili barındırma endişelerine yol açabilir. Verilerin gizliliğini sağlamak için kişisel resimlere izin verilmez. Kişisel görselleri gelecekte desteklemek için çalışıyoruz.
Google Cüzdan API'si hangi hata kodlarını döndürür?
Google Cüzdan API'si tarafından döndürülen hata kodları ve istisnaların listesi için Hata kodları bölümüne bakın.Push bildirimlerini nasıl etkinleştirebilirim?
Geliştirici tarafından yazılan push bildirimleri şu anda Google Cüzdan tarafından desteklenmiyor. Ancak Google Cüzdan, aşağıdaki kartlar için zamanında bildirim sağlar. Geliştirici tarafından yazılan push bildirimleri şu anda Google Cüzdan tarafından desteklenmiyor.
| Sektör | Bildirim | Tetiklendi | Belgeler |
|---|---|---|---|
| Etkinlik | Yaklaşan hatırlatıcı | Etkinlikten 3 saat önce | docs |
| Uçuş kartı | Yaklaşan hatırlatıcı | Uçuşun kalkış saatinden 3 saat önce | docs |
| Uçuş kartı | Kart Güncellemesi | Kalkış terminali, kapı, biniş saati veya kalkış saati değişikliği | docs |
| Teklif kartı | Süre sonu hatırlatıcısı | Teklif kartının süresi dolmadan 48 saat önce | docs |
| Generic | Yaklaşan hatırlatıcı | "Zaman aralığı" başlamadan 24 saat önce | docs |
| Generic | Süre sonu hatırlatıcısı | "Dahili süre" sona ermeden 48 saat önce | docs |
Satıcı kimlikleri silinebilir mi?
Satıcı kimlikleri şu anda Google Pay ve Cüzdan Konsolu'ndan silinemez veya arşivlenemez.
Uygulama bağlama özelliğini nasıl kullanırım?
Uygulama bağlama, izin verilenler listesine ekleme gerektirir. Bu işlem için buradan istek gönderebilirsiniz.
Google Cüzdan coğrafi sınırlamayı destekliyor mu?
Coğrafi sınırlama şu anda desteklenmemektedir.
Bağlılık programı nasıl oluşturabilirim?
Bu kılavuzu uygulayarak kayıt ve bağlılık programı oluşturabilirsiniz.
Toplu taşıma kartları için logomu Google'a nasıl gönderebilirim?
İzin verilenler listesine eklemek için logoyu Google'a göndermek üzere lütfen bu formu kullanın.
Base64 kodlu userProfile verileri nasıl doğru şekilde işlenir?
İşlemin tamamında UTF-8 kodlaması kullandığınızdan emin olun. JSON dizesi önce UTF-8 olarak kodlanır ve ardından NO_WRAP ve URL_SAFE seçenekleriyle android.util.Base64 kullanılarak kodlanır. Bu, RFC 3548 bölüm 4 ile aynıdır.
Programlı olarak nasıl Issuer hesabı oluşturabilirim?
API üzerinden ödeme kuruluşu hesabı oluşturmak için bu kılavuza bakın.
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 listesini burada bulabilirsiniz.
Kartlarımı NFC ile nasıl kullanabilirim?
Kartınızın Smart Tap ile kullanılabilmesi için lütfen bu yapılandırmayı uygulayın.
JSON Web jetonları (JWT'ler)
JWT'lerin uygulanmasını ve hata ayıklamasını kolaylaştıran araçlar var mı?
Evet, www.jwt.io gibi platformlar geliştirme sürecinde jetonlarınızın kodunu çözmenizi ve hata ayıklamanızı sağlar. Bu sayede, gönderdiğiniz içeriği doğrulayabilirsiniz. Google'ın satış ortaklığı olmadığını ve bu tür üçüncü tarafları özel olarak önermediğini unutmayın.
JWT bağlantı URL'm, 1.800 karakterlik tarayıcı kısıtlamasını aşıyor. Ne yapmalıyım?
API'yi kullanarak, şifre kaydetme bağlantısını (JWT) oluşturmadan önce sınıfları ve nesneleri önceden oluşturabilirsiniz.
Sorun giderme
Saat ayarımda neden etkinlik için yanlış saat gösteriliyor?
Kartta gösterilen saat, etkinliğin gerçekleştiği yerel saattir.
Logom, oluşturduğum kartlarda oluşturulmuyor. Sorun ne olabilir?
- Öncelikle, logonuzun kurallara uyduğundan ve PNG biçiminde kaydedildiğinden emin olun.
- Logonun yüksek güvenilirlikle kolayca kullanılabildiğinden emin olun. 404 hatalarına neden olabilecek resim dosyalarına yönlendirmeyin. Aksi takdirde, resimleriniz Google Cüzdan'da görünmeyecektir. Dolayısıyla resimleriniz HTTPS konumunda barındırılmalıdır.
- API'de "zorunlu" olarak işaretlenen tüm zorunlu alanların kartta ayarlandığından emin olun.
Destek ve geri bildirim
Teknik Destek Ekibi ile nasıl iletişime geçebilirim?
Daha fazla yardım için Google Pay ve Cüzdan konsolunun sol kenar çubuğundaki "Destek Ekibi ile İletişime Geç" düğmesini tıklayarak destek ekibiyle iletişime geçin.
Ürünle ilgili geri bildirim nasıl bırakılır?
Ürünle ilgili geri bildirim göndermek 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ında geri bildiriminizi açıklayın ve "Gönder"i tıklayın.
Dokümanlarla ilgili nasıl geri bildirimde bulunabilirim?
Dokümanlar için geri bildirim göndermek üzere geliştirici sitesi sayfasının sağ üst çeyreğindeki "Geri bildirim gönder" düğmesini tıklayın ve "Dokümanlar için geri bildirim"i seçin. Ardından, metin alanında geri bildiriminizi açıklayın ve "Gönder"i tıklayın.