Uygulama Çevirme

OAuth 2.0 uygulamasını tamamladıktan sonra, isteğe bağlı olarak kullanıcılarınızın kimlik doğrulama sisteminizdeki hesaplarını Google Hesaplarına daha hızlı bir şekilde bağlamasına olanak tanıyan Auth tabanlı App Flip hizmetini yapılandırabilirsiniz. Aşağıdaki bölümlerde smart home İşleminiz için App Flip tasarlama ve uygulama yöntemleri açıklanmaktadır.

Tasarım yönergeleri

Bu bölümde, Uygulama Çevirme hesap bağlama izin ekranı için tasarım şartları ve önerileri açıklanmaktadır. Google uygulamanızı aradıktan sonra, uygulamanız kullanıcıya izin ekranını görüntüler.

Koşullar

  1. "Bağlantı kurulduğunda Google'ın cihazlarınızı kontrol etme izni olacak" gibi bir Google yetkilendirme beyanınızın olması gerekir.
  2. 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.
  3. İzin ekranınızda net bir harekete geçirici mesaj belirtmeli ve bağlantı işlemi için "Kabul et ve bağlantı oluştur" ifadesini kullanmalısınız. Bunun nedeni, kullanıcıların, hesaplarını bağlamak için Google ile hangi verileri paylaşmaları gerektiğini anlamalarıdır.
  4. Kullanıcıların bağlantı oluşturmak istemedikleri takdirde geri dönebilecekleri veya iptal edebilecekleri bir yöntem sağlamanız gerekir. İptal işlemi için "İptal" ifadesini kullanın.
  5. Şu iş akışını uygulamanız gerekir: "Kabul et ve bağla"yı tıkladıktan sonra bağlantının başarılı olduğunu göstermeniz ve kullanıcıyı otomatik olarak tekrar Google Home uygulamasına yönlendirmeniz gerekir. Kullanıcı artık işleminizi Google Home uygulamasında da bağlı cihazı görecek. "İptal"i tıkladıktan sonra kullanıcıyı tekrar Google Home uygulamasına yönlendirmeniz gerekir.

Öneriler

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

  1. Google'ın Gizlilik Politikası'nı görüntüleyin. İzin ekranına Google'ın Gizlilik Politikası'nın bağlantısını ekleyin.

  2. Paylaşılacak veriler. Kullanıcıya Google'ın hangi verileri neden istediğini açıklamak için açık ve net bir dil kullanın.

  3. Bağlantıyı kaldırma olanağı. Kullanıcılara, bağlantıyı kaldırmaları için platformunuzdaki hesap ayarlarına yönlendiren bir URL gibi bir mekanizma sunun. Alternatif olarak, kullanıcıların bağlı hesaplarını yönetebileceği bir Google Hesabı bağlantısı ekleyebilirsiniz.

  4. Kullanıcı hesabı değiştirme olanağı. Kullanıcılara hesaplarını değiştirmeleri için bir yöntem önerin. Bu, özellikle kullanıcılar genellikle birden fazla hesaba sahipse yararlıdır.

    • Kullanıcının hesaplar arasında geçiş yapmak için izin ekranını kapatması gerekiyorsa Google'a kurtarılabilir bir hata gönderin. Böylece kullanıcı, OAuth bağlantısı ve dolaylı akışla istediği hesapta oturum açabilir.
  5. Logonuzu ekleyin. İzin ekranında şirket logonuzu gösterin. Logonuzu yerleştirmek için stil kurallarınızı kullanın. Google'ın logosunu da görüntülemek istiyorsanız Logolar ve ticari markalar konusuna bakın.

Bu şekilde, kullanıcı rızası ekranı tasarlarken izlenmesi gereken özel gereksinimlere ve önerilere ilişkin açıklamalar içeren örnek bir izin ekranı gösterilmektedir.
Şekil 1: Hesap bağlama izin ekranı tasarım yönergeleri.

OAuth tabanlı App Flip için kurulum

Aşağıdaki bölümlerde OAuth tabanlı App Flip için ön koşullar ve App Flip projenizi Actions konsolunda nasıl yapılandıracağınız açıklanmaktadır.

Akıllı ev İşlemi oluşturma ve OAuth 2.0 sunucusu kurma

App Flip ürününü yapılandırmadan önce aşağıdakileri yapmanız gerekir:

Actions konsolunda App Flip'i yapılandırın

Aşağıdaki bölümde, Actions Console'da App Flip yapılandırmasının nasıl yapılandırılacağı açıklanmaktadır.

  1. OAuth Client information (OAuth İstemci bilgileri) altındaki tüm alanları doldurun. (App Flip desteklenmiyorsa yedek olarak normal OAuth kullanılır.)
  2. 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.
  3. Geçiş Bağlantı alanını doldurun. Evrensel bağlantılar hakkında daha fazla bilgi için Uygulamaların ve Web Sitelerinin İçeriğinize Bağlantı Oluşturmasına İzin Verme başlıklı makaleyi inceleyin.
  4. İ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.
  5. Kaydet'i tıklayın.

Şimdi, iOS veya Android uygulamanızda App Flip öğesini uygulamak için bir sonraki bölüme geçebilirsiniz.

App Flip uygulamasını yerel uygulamalarınızda uygulayın

App Flip hizmetini uygulamak için uygulamanızdaki kullanıcı yetkilendirme kodunu, Google'dan gelen bir derin bağlantıyı kabul edecek şekilde değiştirmeniz gerekir.

App Flip uygulamasını cihazınızda test edin

Bir İşlem oluşturup App Flip uygulamasını konsolda ve uygulamanızda yapılandırdığınıza göre App Flip ürününü mobil cihazınızda test edebilirsiniz. App Flip uygulamasını test etmek için Google Assistant app veya Google Home app (GHA) kullanabilirsiniz.

Google Assistant app üzerinden App Flip hizmetini 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. Google Assistant uygulamasından hesap bağlama akışını tetikleyin:
    1. Google Assistant app uygulamasını açın.
    2. Ayarlar'ı tıklayın.
    3. Assistant 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.

App Flip uygulamasını Google Home uygulamasından 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. Home uygulamasından hesap bağlama akışını tetikleyin:
    1. Google Home app (GHA) uygulamasını açın.
    2. + düğmesini tıklayın.
    3. Cihazı kur'u tıklayın.
    4. Zaten ayarlanmış bir cihazınız mı var? seçeneğini tıklayın.
    5. Sağlayıcı listesinden smart home İş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.