Bu dokümanda, Google Cüzdan API'sini kullanırken bilmeniz gereken yaygın terminoloji ve kavramlar listelenmektedir.
Pas
Geç
Kartlar, bir kullanıcının Google Cüzdan hesabına kaydetmesi için verilen Kartlar nesnesinin bir örneğidir. Google Cüzdan API'si, yaygın olarak kullanılan çeşitli kart türlerini (biniş kartları, etkinlik biletleri, kimlik kartları vb.) destekler. Google Cüzdan API'si başka bir şekilde özellikle desteklenmeyen kartlar oluşturmak için kullanılabilecek Genel bir kart türü de sağlar.
Çoğu durumda, geçişler hem Kartlar Sınıfı hem de Kartlar Nesnesi kullanılarak oluşturulur.
Kartı Veren
Kartı Veren Kuruluş, kartlar oluşturup bunları Google Cüzdan'a kaydetmeleri için kullanıcılara dağıtan bir tüzel kişidir. Kartı Veren kuruluş, kartların sahibidir ve bunları oluşturabilir, düzenleyebilir ve güncelleyebilir. Paso Verenler, bireysel geliştiriciler, şirketler ve kuruluşların yanı sıra başkaları adına kart oluşturup yayınlayan toplayıcılar (örneğin, etkinlikler için bilet veya perakendeciler için kupon uygulama konusunda uzmanlaşmış bir şirket) olabilir.
Kartlar Sınıfı
Kartlar Sınıfı, kartların oluşturulduğu paylaşılan bir şablon olarak düşünülebilir. Kartlar Sınıfı, kendisini kullanan tüm kartlara dahil edilecek belirli özellikleri tanımlar. Kartı veren kuruluş, her biri stil ve görünüm gibi özellikleri tanımlayan kendine özgü özelliklere ek olarak Akıllı Dokunma, Kayıt ve Oturum Açma gibi ek özelliklere sahip olan birden fazla sınıf oluşturabilir.
Çoğu durumda, ilgili kartın şablonunu tanımlamak için Kartlar Sınıfı ve verilen tekil kartın özelliklerini tanımlamak için Kartlar Nesnesi sağlanarak kart oluşturulur.
Nesneyi Geçirir
Kartlar Nesnesi, bir kullanıcının Google Cüzdanına kaydetmek üzere verdiği bireysel bir kartı tanımlar. Geçirilen Nesneler genellikle kullanıcıya özel bilgiler içerir. Örneğin, Kartlar Sınıfı belirli bir mağaza için bir hediye kartının nasıl görüneceğini tanımlarken, Kartlar nesnesi, bakiye veya son kullanma tarihi gibi belirli ayrıntıları sağlar.
Birçok geçiş örneği arasında paylaşılabilen Kartlar Sınıflarının aksine, verilen her kart için bir Kartlar Nesnesi oluşturulmalıdır.
Kişisel kartlar
Google Cüzdan API'si ile oluşturduğunuz bazı kartlar hassas kullanıcı verileri içerebilir. Kullanıcılarınızın verilerinin güvende kalmasına yardımcı olmak için ek koruma gerektiren bu kartlar, Google Cüzdan API'sinde Genel kişisel kart türü kullanılarak farklı şekilde yönetilir. Genel kişisel kart, hassas verilerin (Google Cüzdan API Kabul Edilebilir Kullanım Politikası'nda tanımlandığı şekilde) pasonuza dahil edildiği durumlarda kullanılmalıdır ve ilk katılım sırasında ek gizlilik denetimlerine ve incelemeye tabi tutulabilir.
Akıllı Ödeme
Akıllı Dokunma, bir mobil cihaz ile bir NFC terminali arasında veri taşımak için Google'a ait bir yakın alan iletişim protokolüdür. Akıllı Dokunma teknolojisi, kullanıcıların telefonlarını uyumlu bir NFC terminaline yakın tutarak Google Cüzdan'larında kayıtlı kartları kullanabilmelerini sağlar.
Akıllı Dokunma protokolünü kartlarınızla kullanmak için Smart Tap özellikli bir terminal sağlayıcı ile ilişki kurmanız gerekir.
API'ler ve SDK
Google Cüzdan API'si
Google Cüzdan API'si, Google tarafından sağlanan ve kullanıcıların Google Cüzdanlarına kaydetmeleri için kartlar oluşturmanıza ve yayınlamanıza olanak tanıyan bir hizmettir. API; Google Cüzdan REST API, Google Cüzdan Android SDK'sı ve Google Cüzdan konsolu dahil olmak üzere birkaç farklı şekilde kullanılabilir.
Google Cüzdan REST API'si
Google Cüzdan REST API, HTTP isteklerini Google Cüzdan API'sine göndererek kartları programlı bir şekilde oluşturmak ve yönetmek için kullanılan bir arayüzdür.
Google Cüzdan REST API'yi kullanmak için bir hizmet hesabı oluşturmak amacıyla da bir Google Cloud hesabına ihtiyacınız vardır. Bu hesap, Google Cüzdan REST API'ye yapılan isteklerin kimliğini doğrulamak için kullanılır.
Google Cüzdan Android SDK
Google Cüzdan Android SDK'sı, Android uygulamalarınızda Google Cüzdan API'si ile çalışmak için kart oluşturma ve verme gibi bir dizi pratik yöntem sağlar.
Google Cüzdan'a ekle
"Google Cüzdan'a ekle" düğmesi
"Google Cüzdan'a ekle" düğmesi, bir kullanıcıya kart göstermek için Google tarafından onaylanmış bir öğedir. Kullanıcı düğmeyi tıkladığında veya düğmeye dokunduğunda, verilen kartın kullanıcının Google Cüzdan'ına ekleme akışını başlatmak için bir "Google Cüzdan'a ekle" bağlantısı tetiklenir.
Kullanıcılarınızın nasıl etkileşim kuracaklarını zaten bildiği bildikleri bir kullanıcı arayüzü öğesi olduğundan, mümkün olduğunda "Google Cüzdan'a Ekle" düğmesini kullanmanız önerilir.
Düğmeyi kullanmaya ilişkin öğeler ve yönergeler Google Cüzdan API'si Marka Yönergeleri'nde mevcuttur.
"Google Cüzdan'a ekle" bağlantısı
"Google Cüzdan'a ekle" bağlantısıyla, kullanıcılara normal köprü üzerinden kart düzenleyebilirsiniz. Bu, e-posta, SMS, web siteleri ve mobil uygulamalar gibi köprü kullanabildiğiniz her yerde kullanılabilir.
"Google Cüzdan'a ekle" bağlantıları, https://pay.google.com/gp/v/save/ URL'sine imzalı bir JWT eklenerek oluşturulur.
Veren hesap
Demo Modu
Sertifikayı Veren hesabınızı oluşturduğunuzda, siz yayınlama erişimi onaylanana kadar hesabınız "Demo Modu"nda kalır. Demo modunda kart oluşturabilirsiniz, ancak bu kartları yalnızca Kartı Veren hesabınızın "Yönetici" veya "Geliştirici" rollerine sahip kullanıcılara veya Google Cüzdan konsolunda test hesabı olarak eklenmiş kullanıcılara sunabilirsiniz.
"Demo Modu"ndayken, verdiğiniz kartların başlığı otomatik olarak "[TEST ONLY]" ifadesiyle başlayarak o kartın yalnızca test amaçlı olduğunu belirtir.
Test hesapları
Sertifikayı Veren hesabınız "Demo Modu"ndayken, hesabınızda "Yönetici" veya "Geliştirici" rollerine sahip olmayan kullanıcılara kart vermek isterseniz bu kullanıcıları Google Cüzdan konsolunda test hesapları olarak eklemeniz gerekir. Test hesabı olarak kaydolan kullanıcılar, sizin verdiğiniz kartları Google Cüzdanlarına ekleyebilir. Bu, kartlarınızı "Demo Modu'ndayken daha geniş bir kitleyle test etmek için faydalıdır.
İşletme profili
Google Cüzdan API'si için kartı veren bir hesap oluşturmak istiyorsanız Google Pay ve Cüzdan konsoluna kaydolurken bir İşletme Profili oluşturmanız gerekir. İşletme Profili, Google'a şirketiniz veya kuruluşunuzla ilgili temel bilgileri sağlar ve yayınlama erişiminin onaylanması gerekir.
Yayınlama erişimi
Herhangi bir kullanıcının Google Cüzdan'ına kaydedebileceği kartları yayınlayabilmeniz için önce yayınlama erişimi onaylamanız gerekir. Yayınlama erişiminin onaylanması için en az bir Kartlar Sınıfı oluşturmuş ve eksiksiz bir işletme profiline sahip olmanız gerekir. Google Cüzdan Android SDK'sını kullanarak kart yayınlamak isteyen kart veren kuruluşlar, uygulamaları için SHA-1 dijital parmak izini de göndermelidir.
Yayınlama erişimi istemek için Google Cüzdan konsoluna gidin ve "Yayınlama Erişimi İste" düğmesini tıklayın. Google Cüzdan ekibi isteğinizi inceler ve size yayınlama erişimi verildiğinde sizi bilgilendirir.
Kimlik doğrulama
JSON Web Token (JWT)
JSON Web Tokens, bilgileri JSON nesnesi olarak güvenli bir şekilde aktarmak için yaygın olarak kullanılan bir endüstri standardıdır. Google Cüzdan API'sini kullanırken, kart örneği oluşturmak için kullanmak istediğiniz Kartlar Nesnesinin ayrıntılarını JWT ("jot" şeklinde telaffuz edilir) olarak kodlar, ardından bu JWT'yi bir istekte Google Cüzdan API'sine gönderirsiniz.
JWT'ler, Google Cüzdan API'sine gönderilmeden önce paylaşılan bir sırla imzalanarak güvende tutulur. Google Cüzdan REST API'yi kullanıyorsanız imzalama sırrı Google Cloud hizmet hesabı anahtarınızdır. Google Cüzdan Android SDK'sını kullanıyorsanız imzalama sırrı, Android uygulamanızın SHA-1 parmak izidir.
Hizmet hesabı
Google Cloud hizmet hesabı, genellikle kişiler yerine bir uygulama veya işlem iş yükü tarafından kullanılan özel bir hesap türüdür. Google Cüzdan API'sinde, Google Cüzdan REST API'ye gönderilen isteklerin kimliğini doğrulamak için bir hizmet hesabı kullanacaksınız.
Hizmet hesapları Google Cloud Console'da oluşturulur. Hizmet hesabı kullanmak için Cloud Console'da Google Cüzdan API'sini etkinleştirmeniz ve hizmet hesabının Google Cüzdan REST API'ye istekte bulunmasına izin vermeniz gerekir.
Hizmet hesabı anahtarı
Hizmet hesabı anahtarı, Google Cüzdan REST API'ye yapılan çağrıların kimliğini doğrulamak için kullanacağınız kimlik bilgisidir. Hizmet hesabı anahtarı son derece hassas kabul edilir. Bu anahtar, Google Cüzdan REST API'yi kullanarak hesabınızın Kartı Veren ile ilgili çoğu özelliğine (Kart Sınıfları ve Kartlar Nesneleri oluşturma dahil) erişim sağladığından gizli tutulmalıdır.
SHA-1 parmak izi
Android uygulama imzalama sertifikanızın SHA-1 parmak izi, Google Cüzdan Android SDK'sını kullandığınızda Google Cüzdan API'sine yapılan çağrıların kimliğini doğrulamak için kullanacağınız kimlik bilgisidir. Sertifikanızın SHA-1 parmak izi, Gradle veya keytool kullanılarak oluşturulur. İsteklerinizde kimlik doğrulaması yapmak üzere parmak izini kullanmak için parmak izini Google Cüzdan konsolunda kaydetmeniz gerekir.