Genel bakış

OAuth tabanlı Uygulama Dönüştürme (App Flip), kullanıcılarınızın kimlik doğrulama sisteminizdeki hesaplarını Google hesaplarına kolayca ve hızlı bir şekilde bağlamalarını sağlar. Uygulamanız, hesap bağlama işlemini başlattığında kullanıcınızın telefonuna yüklenmişse kullanıcı yetkilendirmesi almak için sorunsuz bir şekilde uygulamanıza yönlendirilir.

Bu yaklaşım sayesinde, kimlik doğrulaması yapmak için kullanıcının kullanıcı adını ve şifresini tekrar girmesi gerekmez. Bunun yerine, Uygulama Flip'i uygulamanızda kullanıcının hesabından alınan kimlik bilgilerinden yararlanır. Bir kullanıcı, Google hesabını uygulamanıza bağladıktan sonra, geliştirdiğiniz tüm entegrasyonlardan yararlanabilir.

Uygulama Çeviriyi hem iOS hem de Android uygulamaları için kurabilirsiniz.

Bu şekilde, kullanıcının Google hesabını kimlik doğrulama sisteminize bağlamak için uygulaması gereken adımlar gösterilmektedir. İlk ekran görüntüsünde, Google hesabı uygulamanıza bağlıysa kullanıcının uygulamanızı nasıl seçebileceği gösterilmektedir. İkinci ekran görüntüsünde, Google hesabını uygulamanıza bağlamayla ilgili onay gösterilir. Üçüncü ekran görüntüsünde, Google uygulamasında başarıyla bağlanmış bir kullanıcı hesabı gösterilmektedir.
Şekil 1. Uygulama Çevirici ile bir kullanıcının telefonunda hesap bağlama.

Şartlar

Uygulama Çevirme özelliğini uygulamak için aşağıdaki gereksinimleri karşılamanız gerekir:

  • Android veya iOS uygulamanız olmalıdır.
  • OAuth 2.0 yetkilendirme kodu akışını destekleyen bir OAuth 2.0 sunucusuna sahip olmanız, bu sunucuyu yönetmeniz ve yönetmeniz gerekir.

OAuth bağlantı yetkilendirme kodu akışı hakkında daha fazla bilgi için OAuth sunucunuzu uygulama başlıklı makaleyi inceleyin.

Tasarım yönergeleri

Bu bölümde, Uygulama Dönüşümü hesap bağlama izni ekranı için tasarım gereksinimleri ve öneriler açıklanmaktadır. Google, uygulamanızı çağırdıktan sonra uygulamanız izin ekranını kullanıcıya gösterir.

Şartlar

  1. Kullanıcının hesabının Google Home veya Google Asistan gibi belirli bir Google ürününe değil, Google'a bağlı olduğunu bildirmeniz gerekir.

Öneriler

Aşağıdakileri yapmanızı öneririz:

  1. Google'ın Gizlilik Politikası'nı inceleyin. İzin ekranına Google'ın Gizlilik Politikası'nın bir bağlantısını ekleyin.

  2. Paylaşılacak veriler. Google'a hangi verilerle neden ihtiyaç duyduğunu açıklamak için açık ve net bir dil kullanın.

  3. Harekete geçirici mesaj net olarak ifade edilsin. İzin ekranınızda "Kabul et ve bağla" gibi net bir harekete geçirici mesaj belirtin. Bunun nedeni, kullanıcıların hesaplarını bağlamak için hangi verileri Google ile paylaşmaları gerektiğini anlamalarıdır.

  4. İptal etme. Bağlantı oluşturmamayı seçen kullanıcıların geri dönmesi veya iptal etmesi için bir yol sağlayın.

  5. Bağlantıyı kaldırma özelliği. Kullanıcıların bağlantısını kaldırabilecekleri bir mekanizma sunun (ör. platformunuzdaki hesap ayarlarının URL'si). Alternatif olarak, kullanıcıların bağlı hesaplarını yönetebilecekleri bir Google Hesabı bağlantısı ekleyebilirsiniz.

  6. Kullanıcı hesabını değiştirme yetkisi. Kullanıcıların hesaplarını değiştirmeleri için bir yöntem önerin. Bu, özellikle kullanıcıların birden fazla hesabı varsa faydalıdır.

    • Kullanıcının hesap değiştirmek için izin ekranını kapatması gerekiyorsa Google'a kurtarılabilir bir hata gönderin. Böylece, OAuth bağlantısı ve örtük akışla istediğiniz hesapta oturum açabilir.
  7. Logonuzu ekleyin. Onay ekranında şirket logonuzu görüntüleyin. Logonuzu yerleştirmek için stil yönergelerinizi kullanın. Google'ın logosunu da göstermek isterseniz Logolar ve ticari markalar konusuna bakın.

Bu şekilde, bir kullanıcı rızası ekranı tasarlarken uymanız gereken ayrı ayrı gereksinimler ve öneriler içeren ek açıklamalar içeren bir izin ekranı örneği gösterilmektedir.
Şekil 2. Hesap bağlama izni ekranı tasarım yönergeleri.

OAuth tabanlı Uygulama Çevirme için kurulum

Aşağıdaki bölümlerde OAuth tabanlı Uygulama Çevir özelliğinin ön koşulları ve Actions Console'da Uygulama Çevir projenizi nasıl yapılandıracağınız açıklanmaktadır.

İşlem oluşturun ve OAuth 2.0 sunucusu ayarlayın

App Flip'i yapılandırmadan önce aşağıdakileri yapmanız gerekir:

  • İşlem oluşturun. İşlem oluşturmak için Proje oluştur bölümündeki talimatları uygulayın.
  • Bir OAuth 2.0 sunucusu kurun. OAuth sunucusu kurulumu hakkında daha fazla bilgi için OAuth hesap bağlamayı uygulama başlıklı makaleyi inceleyin.

Actions konsolunda Uygulama Çevirme'yi yapılandırma

Aşağıdaki bölümde, Actions Console'da Uygulama Çevirme'yi nasıl yapılandıracağınız açıklanmaktadır.

  1. Üst gezinme menüsünde Geliştir'i tıklayın. Ardından, sol gezinme menüsünde Hesap bağlama'yı tıklayın.
  2. Hesap bağlama'nın yanındaki anahtarı açık konumuna getirin.
  3. Hesap oluşturma bölümünde Hayır, yalnızca web sitemde hesap oluşturulmasına izin vermek istiyorum'u seçin.
  4. İleri'yi tıklayın.
  5. Bağlantı türü bölümünde, açılır menülerden OAuth ve Yetkilendirme kodu'nu seçin.
  6. İleri'yi tıklayın.
  7. OAuth İstemci bilgileri altındaki tüm alanları doldurun. (Uygulama Çevirme desteklenmiyorsa yedek olarak normal OAuth kullanılır.)
  8. İleri'yi tıklayın.
  9. Hesap bağlama için uygulamanızı kullanın (isteğe bağlı) bölümünde iOS için etkinleştir'i işaretleyin.
  10. Geçiş Bağlantıları alanını doldurun. Geçiş bağlantıları hakkında daha fazla bilgi için Uygulamaların ve Web Sitelerinin İçeriğinize Bağlantı Vermesine İzin Verme başlıklı makaleye göz atın.
  11. İstemcinizi isteğe bağlı olarak yapılandırmak istiyorsanız kapsamları ekleyin ve İstemcinizi yapılandırın (isteğe bağlı) bölümünde Kapsam ekle'yi tıklayın. Bağlı değilse İleri'yi tıklayın.
  12. Test talimatlarının altında, yer tutucu olarak test (veya başka bir dize) yazın. (Bu alanı bir test hesabıyla doldurmak yalnızca İşleminizi yayınlanmak üzere gerçekten gönderiyorsanız gereklidir.)
  13. Kaydet'i tıklayın.

Şimdi, iOS veya Android uygulamanızda Uygulama Çevirme'yi uygulamak için bir sonraki bölüme geçebilirsiniz.

Yerel uygulamalarınızda Uygulama Çevirme'yi kullanma

Uygulama Çevirme'yi uygulamak için uygulamanızdaki kullanıcı yetkilendirme kodunu, Google'dan gelen derin bağlantıyı kabul edecek şekilde değiştirmeniz gerekir.

Cihazınızda Uygulama Çevirme'yi test edin

Bir İşlem oluşturup hem konsolda hem de uygulamanızda Uygulama Çevirme'yi yapılandırdığınıza göre, Uygulama Çevirme'yi mobil cihazınızda test edebilirsiniz. Uygulama Çevir'i test etmek için Google Asistan uygulamasını kullanabilirsiniz.

Asistan uygulamasından Uygulama Çevirme'yi test etmek için şu adımları uygulayın:

  1. Actions Console'a gidin ve projenizi seçin.
  2. En üstteki gezinme menüsünde Test et'i tıklayın.
  3. Hesap bağlama akışını Asistan uygulamasından tetikleyin:
    1. Google Asistan uygulamasını açın.
    2. Ayarlar'ı tıklayın.
    3. Asistan sekmesinde Ev Kontrolü'nü tıklayın.
    4. Ekle(+) seçeneğini tıklayın.
    5. Sağlayıcı listesinden İşleminizi seçin. Listede "[test]" öneki bulunur. Listeden [test] İşleminizi seçtiğinizde uygulamanız açılır.
    6. Uygulamanızın başlatıldığını doğrulayın ve yetkilendirme akışınızı test etmeye başlayın.