Home API'leri, yapıdaki cihazlara erişim izni vermek için OAuth 2.0'ı kullanır. OAuth, kullanıcıların giriş kimlik bilgilerini ifşa etmeden bir uygulamaya veya hizmete izin vermesine olanak tanır.
Doğrulanmış bir OAuth istemciniz varsa (örneğin, daha önce yayınlanmış bir uygulamadan) yeni bir istemci oluşturmadan Home API'leri test etmek için bu istemciyi kullanabilirsiniz. Daha fazla bilgi için Mevcut bir OAuth istemciniz varsa başlıklı makaleyi inceleyin.
Uygulamayı imzalama
Öncelikle, uygulamanızı Android Studio içinde çalıştırarak bir hata ayıklama sertifikası oluşturun. Android Studio uygulamasında bir uygulamayı çalıştırdığınızda veya hata ayıklama yaptığınızda, geliştirme ve hata ayıklama için otomatik olarak bir hata ayıklama sertifikası oluşturulur. Ayrıntılı açıklama için Android Studio: Hata ayıklama derlemenizi imzalama başlıklı makaleyi inceleyin.
Uygulama çalışmaya başladıktan sonra:
Mobil cihazınızı yerel makinenize bağlayın. Android Studio, bağlı cihazlarınızı model numarasına göre listeler. Listeden cihazınızı seçin ve Run project'i (Projeyi çalıştır) tıklayın. Bu işlem, örnek uygulamayı derleyip mobil cihazınıza yükler.
Daha ayrıntılı talimatlar için Android Developers sitesindeki Uygulamaları donanım cihazında çalıştırma başlıklı makaleyi inceleyin.
Çalışan uygulamayı durdurun.
Google Cloud Console Yardım sitesindeki OAuth 2.0 / Yerel uygulamalar / Android'i ayarlama bölümünde ayrıntılı olarak açıklanan talimatları uygulayarak hata ayıklama sertifikasının SHA-1 parmak izini alın.
OAuth kullanıcı rızası ekranını ayarlama
- Google Cloud konsolunda proje seçici kontrol paneline gidin ve OAuth kimlik bilgilerini oluşturmak için kullanmak istediğiniz projeyi seçin.
- API'ler ve Hizmetler sayfasına gidin ve gezinme menüsünde Kimlik bilgileri'ni tıklayın.
Bu Google Cloud projesi için kullanıcı rızası ekranınızı henüz yapılandırmadıysanız Configure consent screen (Kullanıcı rızası ekranını yapılandır) düğmesi görünür. Bu durumda, aşağıdaki prosedürü kullanarak kullanıcı rızası ekranınızı yapılandırın. Aksi takdirde bir sonraki bölüme geçin.
- Kullanıcı rızası ekranını yapılandır'ı tıklayın. OAuth kullanıcı rızası ekranı sayfası gösterilir.
- Kullanım alanınıza bağlı olarak Dahili veya Harici'yi seçin ve Oluştur'u tıklayın. OAuth kullanıcı rızası ekranı bölmesi gösterilir.
- Uygulama bilgileri sayfasında ekrandaki talimatlara göre bilgileri girin ve ardından Kaydet ve devam et'i tıklayın. Kapsamlar bölmesi görüntülenir.
- Herhangi bir kapsam eklemeniz gerekmediğinden Kaydet ve devam et'i tıklayın. Test kullanıcıları paneli gösterilir.
- Kitle'yi ve + KULLANICI EKLE düğmesini tıklayın.
- Test kullanıcısı e-posta adresinizi girin ve KAYDET düğmesini tıklayın.
- Kaydet ve devam et'i tıklayın. Özet bölmesi gösterilir.
- OAuth kullanıcı rızası ekranı bilgilerinizi inceleyin ve Kontrol paneline dön'ü tıklayın.
Tüm ayrıntılar için Google Cloud Console Yardım sitesindeki OAuth kullanıcı rızası ekranınızı ayarlama başlıklı makaleyi inceleyin.
Uygulamayı kaydetme ve kimlik bilgileri oluşturma
Uygulamayı OAuth 2.0 için kaydetmek ve OAuth kimlik bilgileri oluşturmak için OAuth 2.0'ı ayarlama bölümündeki talimatları uygulayın. Uygulama türünü belirtmeniz gerekir. Bu tür, yerel/Android uygulaması'dır.
Uygulamayı imzalayarak elde ettiğiniz SHA-1 parmak izini, Google Cloud Console Yardım sitesindeki OAuth 2.0'ı ayarlama / Yerel uygulamalar bölümünde yer alan talimatları uygulayarak Google Cloud Console'da oluşturduğunuz OAuth istemcisine ekleyin.
Mobil cihazınız yerel makinenize bağlıyken listeden cihazınızı seçin ve çalıştırmak için Run project'i (Projeyi çalıştır) tekrar tıklayın. Daha ayrıntılı talimatlar için Android Developers sitesindeki Uygulamaları donanım cihazda çalıştırma başlıklı makaleyi inceleyin.
Mevcut bir OAuth istemciniz varsa
Yayınlanmış bir uygulama için doğrulanmış bir OAuth istemciniz varsa Home API'leri test etmek için mevcut OAuth istemcinizi kullanabilirsiniz.
Home API'lerini test etmek ve kullanmak için Google Home Developer Console kaydı gerekli değildir. Ancak başka bir entegrasyondan doğrulanmış bir OAuth istemciniz olsa bile uygulamanızı yayınlamak için onaylanmış bir Developer Console kaydınızın olması gerekir.
Aşağıdaki hususlar geçerlidir:
Mevcut bir OAuth istemcisini kullanırken 100 kullanıcı sınırı vardır. Test kullanıcıları ekleme hakkında bilgi içinOAuth kullanıcı rızası ekranını ayarlayın. OAuth doğrulamasından bağımsız olarak, Home API'leri tarafından uygulamanıza izin verebilecek kullanıcı sayısı 100 ile sınırlandırılmıştır. Developer Console kaydı tamamlandığında bu sınırlama kaldırılır.
Developer Console registration , uygulamanızı Home API'leri ile güncellemeye hazırlanırken OAuth üzerinden cihaz türü izinlerini kısıtlamaya hazır olduğunuzda onaya gönderilmelidir.
OAuth doğrulaması hâlâ beklemede olan Google Cloud uygulama için kullanıcılar, doğrulama tamamlanana kadar OAuth akışını tamamlayamaz. İzin verme girişimleri aşağıdaki hatayla başarısız olur:
Access blocked: <Project Name> has not completed the Google verification process.