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. Daha yakın bir zamanda, ek kullanım alanlarını desteklemek için genel bir kart türü eklendi.

Geliştirme ortamımı işletme gereksinimlerime ve karmaşıklığına göre nasıl ayarlayabilirim?

Aşağıda, farklı düzeylerdeki işletme karmaşıklığına ve güvenliğe uygun bir geliştirme ortamı oluşturmak için kullanılabilecek kılavuzlar yer almaktadır. Birden fazla hizmet hesabı kullanmak, geliştiricilerin üretim ortamlarından ayrı bir TEST ortamı oluşturmasına olanak tanır.

Temel kurulum karmaşıklığı

1 işletme konsolu hesabı veya 1 işletme konsolu üst hesabı, birçok kart veren hesabına bağlanabilir.

  • Bu seçenek, sıfırdan çok sayıda alt işletme/ihracatçı içeren 1 ana hesapla 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, birçok veren hesabına bağlanabilir.

  • Bu seçenek, birçok alt işletmeye sahip 1 ana hesap kullanılarak merkezi olarak yönetilen bir yaklaşım sağlar.
  • 1 Google Cloud projesi.
  • Düzenleyen kuruluş başına farklı işletme konsolu kullanıcıları.
  • 1-çok hizmet hesabı kimlik bilgisi.
    • İşletme/düzenleyen başına 1 kimlik bilgisi.
    • İşletme başına farklı kimlik bilgisi erişimi.

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

1 üst hesap, birçok veren hesabına bağlanabilir.

  • Bu seçenek, birçok alt işletmeye sahip 1 ana hesap kullanılarak merkezi olarak yönetilen bir yaklaşım sağlar.
  • 1'den çok Google Cloud projesine.
  • Düzenleyen kuruluş başına farklı işletme konsolu kullanıcıları.
  • 1-çok hizmet hesabı kimlik bilgileri.
    • İşletme/düzenleyen başına 1 PROD kimlik bilgisi.
    • İşletme/düzenleyen kuruluş 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üzdan hesaplarından nesnelerin bağlantısını kaldırabilirler.

Birden fazla kartı nasıl gruplandırabilirim?

GroupingID özelliğini kullanarak kartları kolayca gruplandırabilirsiniz.

Kartın yalnızca bir bölümünü nasıl güncelleyebilirim?

PATCH isteklerini kullanarak nasıl kısmi güncellemeler yapacağınızı öğrenmek için performans kılavuzumuzu inceleyin.

Toplu olarak kart oluşturabilir miyim?

API'yi kullanarak toplu istekleri nasıl gerçekleştireceğinizi anlamak için performans kılavuzumuzu inceleyin.

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 istek ile sınırlıdır.

Google Cüzdan API'sinin resmi bir SLA'sı yoktur ancak yaklaşık 5 saniyelik %99'luk bir gecikmeye dayanarak 10 saniyelik bir zaman aşımı öneririz. Ayrıca, gecikmenin genellikle harici faktörlere bağlı olduğunu unutmayın. Örneğin, bir nesne eklerken harici bir sunucuda barındırılan bir görüntünün getirilmesi için gereken süre, harici sunucunun gecikmesine bağlı olduğundan gecikmeyi etkiler.

Google Cüzdan'daki kartlarda neden kişisel resimlerin kullanılması yasaktır?

Google Cüzdan, kartlarda kişisel resimleri desteklemez. Bunun nedeni, mevcut düzenlemelerde tüm tüketicilerin hassas verilerin toplanmasını veya işlenmesini devre dışı bırakma hakkının olduğunun belirtilmesidir. Değerli nesnenin (JWT'de) bir parçası olarak hassas verilerin (kişisel resimler) bulunması, verilerin herkese açık hale gelebileceği ve orijinal izin sözleşmesinin dışında kalabileceği barındırma sorunlarına yol açabilir. Verilerin gizliliğini sağlamak için kişisel resimlere izin verilmez. Gelecekte kişisel resimlerin desteklenmesi 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ştiriciler tarafından oluşturulan anlık bildirimler şu anda Google Cüzdan tarafından desteklenmemektedir. Ancak Google Cüzdan, aşağıdaki kartlar için zamanında bildirimler gönderir. Geliştiriciler tarafından oluşturulan anlık bildirimler ş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ş kalkışından 3 saat önce docs
Uçuş kartı Kart güncelleme Kalkış terminali, kapısı, uçağa 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
Genel Yaklaşan hatırlatıcı "Zaman aralığı" başlamadan 24 saat önce docs
Genel Süre sonu hatırlatıcısı "Zaman aralığı" sona ermeden 48 saat önce docs

Satıcı kimlikleri silinebilir mi?

Şu anda satıcı kimlikleri Google Pay ve Cüzdan Konsolu'ndan silinemez veya arşivlenemez.

Uygulama bağlantısı özelliğini nasıl kullanırım?

Applinking için izin verilenler listesine ekleme gerekir. Bu işlem için buradan istekte bulunabilirsiniz.

Google Cüzdan, coğrafi sınırlama özelliğini destekliyor mu?

Coğrafi sınırlama şu anda desteklenmemektedir.

Bağlılık programını nasıl oluştururum?

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

Toplu taşıma kartları için logomu Google'a nasıl gönderirim?

İzin verilenler listesine eklemek için lütfen bu formu kullanarak Google'a logoyu gönderin.

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

Tüm süreç boyunca UTF-8 kodlaması kullandığınızdan emin olun. JSON dizesi önce UTF-8 olarak kodlanır, ardından NO_WRAP ve URL_SAFE seçenekleriyle android.util.Base64 kullanılarak kodlanır. Bu, RFC 3548 bölüm 4 ile uyumludur.

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

API aracılığıyla veren hesabı oluşturmak için bu kılavuza bakın.

Akıllı Ödeme

Google Smart Tap kartları için özel bir NFC okuyucuya ihtiyacım var mı?

Temassız ödeme ö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ı Temas ile kullanılabilmesi için lütfen bu yapılandırmayı uygulayın.

JSON web jetonları (JWT'ler)

JWT'lerin uygulanmasını ve hatalarının ayıklanmasını kolaylaştıran araçlar var mı?

Evet, www.jwt.io gibi platformlar, geliştirme sürecinizde jetonlarınızın kodunu çözmenize ve hata ayıklamanıza olanak tanıyarak gönderdiğiniz içeriği doğrulamanızı sağlar. Google'ın bu üçüncü taraflarla bağlantısı olmadığını ve herhangi birini özel olarak önermediğini lütfen unutmayın.

API'yi kullanarak, kartı 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 yerin saat dilimine göre ayarlanmış etkinlik saatidir.

Oluşturduğum kartlarda logom oluşturulmuyor. Sorun ne olabilir?

  • Öncelikle logonuzun kurallara uygun olduğundan ve PNG biçiminde kaydedildiğinden emin olun.
  • Logonun yüksek güvenilirlikle kolayca kullanılabilir olduğundan emin olun. 404 hatalarına neden olabilecek resim dosyalarına yönlendirme yapmayın. Resimleriniz, aksi takdirde Google Cüzdan'da görünmeyecekleri için HTTPS konumunda barındırılmalıdır.
  • API'de zorunlu olarak işaretlenen tüm gerekli alanların kartta ayarlandığından emin olun.

Destek ve geri bildirim

Teknik destek ekibiyle nasıl iletişime geçebilirim?

Daha fazla yardım 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ün geri bildirimi nasıl gönderilir?

Ürün geri bildirimi göndermek için geliştirici sitesi sayfasının sağ üst bölümündeki "Geri bildirim gönder" düğmesini tıklayın ve "Ürün geri bildirimi"ni seçin. Ardından, geri bildiriminizi metin alanında açıklayın ve "Gönder"i tıklayın.

Dokümanlarla ilgili nasıl geri bildirimde bulunabilirim?

Dokümanlarla ilgili geri bildirim göndermek için geliştirici sitesi sayfasının sağ üst bölümündeki "Geri Bildirim Gönder" düğmesini tıklayın ve "Dokümanlarla ilgili geri bildirim"i seçin. Ardından, geri bildiriminizi metin alanında açıklayın ve "Gönder"i tıklayın.