Kullanıcı Hediye Kartı kaydı

Hediye Kartı kayıt (oturum açma) özelliği, kullanıcıların bir hediye kartını Google Cüzdan'a ekleyin. Kullanıcılar, Bu işlemden sonra kartlarını Google Cüzdan'a ekleyebilirler.

Bu kılavuzda, gerekli uygulama adımlarına genel bir bakış sunulmaktadır. Bu özelliği kullanmak üzere hediye kartı programınızı etkinleştirin.

Genel Bakış

Başlamak için projenizi önceden oluşturduğunuzdan ve Google Cüzdan API'si.

Hediye kartı programınızda oturum açma özelliğini uygulamak için aşağıdaki dört adımı uygulamanız gerekir:

  1. Oturum açma akışınızı test etmek için Google Cüzdan'da bir test sınıfı oluşturun.
  2. Google Cüzdan SharedDataType kullanan oturum açma sayfaları geliştirin.
  3. Oturum açtıktan sonra hediye kartının Google Cüzdan'a geri gönderilmesini uygulayın.
  4. Doğrulama ve etkinleştirme isteğinde bulunun.

Google Cüzdan'da test sınıfı oluşturma

Oturum açma URL'sini, program logonuzu belirleyin. Ardından, uygun değerleri ayarlamak için giftcardclass içindeki discoverableProgram iç içe yerleştirilmiş alanlarını kullanın.

Sitenizin taslak sürümünü oluşturmak için discoverableProgram içindeki değerleri ayarlayın oturum açma etkinleştirilmiş hediye kartı programı. Test kullanıcılarının bunu görebilmesi için şunu doğrulayın: Test kullanıcılarının Google Pay ve Cüzdan Konsolunuza erişimi olmalıdır. Verilerinizi paylaşmayla ilgili ayrıntılı bilgi için Google Pay ve Cüzdan Konsolu'nun diğer kullanıcılarla erişimi, bkz. Kullanıcılar sayfası hakkında bilgi edinin.

Geliştirme sürecinde uygulamanızın işlevselliğinin doğrulamasını tamamlamak için Google Pay ve Cüzdan Console'daki destek iletişimi widget'ını kullanarak bize ulaşın. Konsoldayken, konuda Google Cüzdan API'yi ve alt konuda Hediye kartı oturumu açma'yı seçin.

Google Cüzdan kullanıcı verilerinin kullanıldığı oturum açma sayfası geliştirin

Bir kullanıcı hediye kartınızı eklemeyi seçtiğinde web sitenizde özelleştirilmiş bir sayfaya yönlendirildiklerinden oturum açmanızı sağlar.

Kullanıcıların oturum açabileceği bir oturum açma URL'si sağlamanız gerekir oturum açın.

Oturum açma sayfanız aşağıdaki şartları karşılamalıdır:

  • Mobil cihazlara uygun bir kullanıcı deneyimi sağlayın.
  • Kullanıcının oturum açma işlemini tek bir sayfada tamamlamasına izin verin.
  • Kullanıcı verilerinin güvenli bir şekilde iletilmesini sağlamak için geçerli bir sertifikayla HTTPS şifrelemeyi kullanın.
  • Oturum açma sayfanızın en az %99,9 çalışma süresi olduğundan emin olun.

Google Cüzdan, oturum açma sayfasını sunarken bir Android WebView oluşturur ve sağladığınız URL'ye bir POST isteği gönderilir. Kullanıcı verileri, POST isteğine application/x-www-form-urlencoded içerik türü ve UTF-8 kodlaması kullanılarak dahil edilen SharedDataType parametresinde sağlanır. SharedDataType değeri parametresi, Base64 olarak kodlanmış JSON nesnesidir.

Hediye kartını Google Cüzdan'a hemen gönderin

Kimliği doğrulandıktan (oturum açtıktan) sonra, sayfanız Kullanıcının hediye kartını hemen Google Cüzdan'a geri göndermelidir.

Şu adrese yönlendirerek hediye kartınızı Google Cüzdan'a geri aktarabilirsiniz: bu yapıyı takip eden bağlantı

https://pay.google.com/gp/v/save/{jwt_generated}

URL'ler en fazla 2.000 karakter uzunluğunda olabilir. Bağlantılarınız korunduğundan emin olabilirsiniz. JWT'lerde kodlanan nesneler küçük olmalı ve yalnızca kullanıcıya özgü veriler içermelidir. JWT oluşturmadan önce, çoğu veriyi nesnenin sınıfında tutmaya çalışın. Bu sınıra uymayan daha büyük nesneler için önce nesneyi Google Cüzdan API'si kullanabilir ve JWT'de yalnızca nesne kimliğini gönderebilir.

Tipik İletişim Akışı

Oturum açma işlemini tamamlayan bir kullanıcının iletişim akışı ekleyebilirsiniz. "Sunucunuz" ile ilgili tüm işlemleri uygulamak sizin sorumluluğunuzdadır.

Oturum açma akışları

Doğrulama ve etkinleştirme isteğinde bulunma

Geliştirme çalışmasını tamamlayıp oturum açma akışınızı test ettikten sonra istek gönderin aracılığıyla Google Pay ve Cüzdan Konsolu destek ekibiyle iletişime geçin widget'ını tıklayın.

Uygulamanızın tamamını inceledikten sonra, özelliği ile birlikte hediye kartı oturum açma özelliği de hediye kartı programınız için herkese açık olarak yayınlandı. Bu sayede tüm kullanıcılar programı görebilir ve bu özelliği kullanabilir.

En iyi kullanıcı deneyimini sağlamak amacıyla, özellik şartlarına sürekli olarak uyulmasını sağlamak için oturum açma uygulamanızla ilgili tekrarlanan kontroller yapılır. Tutarsızlık olması durumunda bilgilendirilirsiniz ve sorun çözülene kadar oturum açma özelliği devre dışı bırakılabilir.

Sık Sorulan Sorular

  • Hediye kartı programımda kullanılan resimler için herhangi bir koşul var mı?
    • Evet, resimleriniz HTTPS konumunda barındırılmalıdır. Aksi takdirde Google Cüzdan'da görünmezler.
  • 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üreciniz sırasında jetonlarınızın kodunu çözmenize ve hata ayıklamanıza olanak tanır. Böylece, gönderdiğiniz içeriği doğrulayabilirsiniz. Google'ın bu üçüncü taraflarla herhangi bir bağlantısı olmadığını ve bu tür üçüncü taraflardan herhangi birini özellikle önermediğini unutmayın.
  • Base64 kodlamalı SharedDataType verilerini doğru şekilde nasıl işliyoruz?
    • İşleminiz boyunca UTF-8 kodlaması kullandığınızdan emin olun. JSON dizesi ilk UTF-8 olarak ve daha sonra android.util.Base64 ve (NO_WRAP ve URL_SAFE) seçeneklerine gidin. Bu, RFC 3548 bölüm 4'e karşılık gelir.