Google Cüzdan API'si Hakkında SSS

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. Kısa süre önce, ek kullanım alanlarını desteklemek için genel bir geçiş türü eklendi.

Geliştirme ortamımı işletme gereksinimlerime ve karmaşıklık düzeyine göre nasıl ayarlayabilirim?

Aşağıda, işletmenin karmaşıklığı ve güvenliğiyle ilgili farklı düzeylere uygun bir geliştirme ortamı oluşturmak için kullanılabilecek kılavuzlar bulunmaktadır. Birden fazla hizmet hesabı kullanmak, geliştiricilerin PROD ortamlarından ayrı bir TEST ortamı oluşturmasını sağlayabilir.

Temel kurulum karmaşıklığı

1 Business Console hesabı veya 1 Business Console üst hesabı, kartı veren birçok hesap için geçerlidir.

  • Bu seçenek, sıfır veya çok sayıda alt işletme/kredi veren 1 ana hesap kullanılarak merkezi olarak yönetilen bir yaklaşım sağlar.
  • 1 Google Cloud Projesi.
  • 1 hizmet hesabı kimlik bilgisi.
  • Tek kullanıcı grubu.

Ortalama kurulum karmaşıklığı

1 üst hesaba, kartı veren çok sayıda hesaba.

  • Bu seçenek, çok sayıda alt işletmeye sahip 1 ana hesap kullanılarak merkezi olarak yönetilen bir yaklaşım sağlar.
  • 1 Google Cloud Projesi.
  • Kartı veren kuruluşa göre farklı Business Console kullanıcısı sayısı.
  • 1-çok hizmet hesabı kimlik bilgisi.
    • İşletme/yayıncı başına 1 yeterlilik belgesi.
    • İşletme başına farklı kimlik bilgisi erişimi.

Karmaşık kurulum karmaşıklığı

1 üst hesaba, kartı veren çok sayıda hesaba.

  • Bu seçenek, çok sayıda alt işletmeye sahip 1 ana hesap kullanılarak merkezi olarak yönetilen bir yaklaşım sağlar.
  • 1'den çok sayıda Google Cloud projesine
  • Kartı veren kuruluşa göre farklı Business Console kullanıcısı sayısı.
  • 1-çok hizmet hesabı kimlik bilgisi.
    • İşletme/yayıncı başına 1 PROD kimlik bilgisi.
    • İşletme/yayıncı başına 1 DEV kimlik bilgisi.

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üzdanlarından nesnelerin bağlantısını kaldırabilir.

Birden fazla kartı nasıl gruplandırabilirim?

GroupingID, kartları gruplandırmayı kolaylaştırır.

Kartın yalnızca bir kısmını nasıl güncelleyebilirim?

YAMA isteklerini kullanarak kısmi güncellemeleri nasıl gerçekleştireceğinizi öğ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 inceleyin.

Genel Sorular

Google Cüzdan API'sine gönderilen istekler için hız sınırı nedir?

Google Cüzdan API'sine yapılan çağrılar, saniyede 20 istekle sınırlandırılmıştır.

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ş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 bildirimler sağlar. Geliştirici tarafından oluşturulan push bildirimleri şu anda Google Cüzdan tarafından desteklenmemektedir.

Dikey Bildirim Tetiklendi Belgeler
Etkinlik Yaklaşan hatırlatıcı Etkinlikten 3 saat önce docs
Uçuş kartı Yaklaşan hatırlatıcı Uçuştan 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 zaman" 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ğlantısı verme özelliğini nasıl kullanırım?

Uygulama bağlantısı oluşturmak için izin verilenler listesine eklenmesi gerekir. İzin verilenler listesine eklenmeyi buradan talep edebilirsiniz.

Google Cüzdan Geofencing'i destekliyor mu?

Coğrafi sınır çizme şu anda desteklenmemektedir.

Nasıl bağlılık programı oluşturabilirim?

Bu kılavuzu takip ederek kayıt ve bağlılık programı oluşturabilirsiniz.

Toplu taşıma kartlarındaki logomu Google'a nasıl gönderebilirim?

İzin verilenler listesine eklenecek logoyu Google'a göndermek için lütfen bu formu kullanın.

Base64 olarak kodlanmış userProfile verileri doğru şekilde nasıl işlenir?

Süreç boyunca UTF-8 kodlamasını kullandığınızdan emin olun. JSON dizesi önce UTF-8, ardından NO_WRAP ve URL_SAFE seçenekleriyle android.util.Base64 kullanılarak kodlanır. Bu, RFC 3548 bölüm 4'e karşılık gelir.

Düzenleyen hesaplarını programatik olarak nasıl oluşturabilirim?

API aracılığıyla kartı veren hesaplar oluşturmak için bu kılavuzu inceleyin.

Akıllı Ödeme

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ın NFC ile çalışmasını nasıl sağlarım?

Kartınızın Akıllı Dokunma ile kullanılabilmesi için lütfen bu yapılandırmayı uygulayın.

JSON web jetonları (JWT)

JWT'nin uygulanmasını ve hata ayıklamasını basitleştiren araçlar var mı?

Evet, www.jwt.io gibi platformlar, geliştirme süreciniz sırasında jetonlarınızın kodunu çözmenizi ve hata 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ü tarafları özel olarak önermediğini unutmayın.

Kaydet bağlantısı (JWT) oluşturmadan önce API'yi kullanarak sınıfları ve nesneleri önceden oluşturabilirsiniz .

Sorun giderme

Zaman ayarımda neden etkinlik için yanlış saat görüntüleniyor?

Kartta görüntülenen saat, etkinliğe ait yerel saattir ve etkinliğin bulunduğu saat için ofseti gösterir.

Oluşturduğum Kartlar üzerinde logom görüntülenmiyor. Sorun ne olabilir?

  • Öncelikle logonuzun kurallara uyduğundan ve PNG biçiminde kaydedildiğinden emin olun.
  • Logonun yüksek güvenilirlik ile kullanıma hazır olduğundan emin olun. 404 hatalarına neden olabilecek resim dosyalarına yönlendirme yapmayın. Aksi takdirde Google Cüzdan'da görünür olmayacakları için resimleriniz HTTPS konumunda barındırılmalıdır.
  • API'de zorunlu olarak işaretlenen tüm zorunlu alanların geçişte ayarlandığından emin olun.

Destek ve geri bildirim

Teknik desteğe nasıl ulaşabilirim?

Daha fazla yardım almak için Google Pay ve Cüzdan konsolunun sol kenar çubuğundaki "Destek Ekibiyle İletişime Geçin" düğmesini tıklayarak destek ekibiyle iletişime geçin.

Ürünle ilgili nasıl geri bildirim gönderebilirim?

Ürünle ilgili geri bildirim bırakmak için geliştirici sitesi sayfasının sağ üst çeyreğinde bulunan "Geri Bildirim Gönder" düğmesini tıklayıp "Ü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?

Belgelerle ilgili geri bildirim bırakmak için geliştirici sitesi sayfasının sağ üst çeyreğinde "Geri Bildirim Gönder" düğmesini tıklayıp "Belge geri bildirimi"ni seçin. Ardından, metin alanında geri bildiriminizi açıklayın ve "Gönder"i tıklayın.