Home API'leri, yapıdaki cihazlara erişim izni vermek için OAuth 2.0'ı kullanır. OAuth, kullanıcını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 bu istemciyi kullanarak Home API'lerini test edebilirsiniz. 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'da bir uygulamayı çalıştırdığınızda veya uygulamada hata ayıklama işlemi yaptığınızda, geliştirme ve hata ayıklama için otomatik olarak bir hata ayıklama sertifikası oluşturulur. Tam açıklama için Android Studio: Hata ayıklama derlemenizi imzalama başlıklı makaleyi inceleyin.
Uygulama çalıştı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çip Projeyi çalıştır'ı tıklayın. Bu işlem, örnek uygulamayı mobil cihazınızda oluşturup yükler.
Daha ayrıntılı talimatlar için Android Developers sitesindeki Run apps on a hardware device (Uygulamaları donanım cihazda ç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 izin ekranını ayarlama
- Google Cloud Console'da proje seçici kontrol paneline gidin ve OAuth kimlik bilgileri oluşturmak için kullanmak istediğiniz projeyi seçin.
- API'ler ve Hizmetler sayfasına gidip gezinme menüsünde Kimlik Bilgileri'ni tıklayın.
Bu Google Cloud projesi için izin ekranınızı henüz yapılandırmadıysanız İzin ekranını yapılandır düğmesi görünür. Bu durumda, aşağıdaki prosedürü kullanarak izin ekranınızı yapılandırın. Aksi takdirde bir sonraki bölüme geçin.
- İzin ekranını yapılandır'ı tıklayın. OAuth izin ekranı sayfası gösterilir.
- Kullanım alanınıza bağlı olarak Dahili veya Harici'yi seçip Oluştur'u tıklayın. OAuth izin ekranı bölmesi gösterilir.
- Uygulama bilgileri sayfasında ekrandaki talimatlara göre bilgileri girin ve Kaydet ve devam et'i tıklayın. Kapsamlar bölmesi gösterilir.
- Kapsam eklemeniz gerekmez. Bu nedenle Kaydet ve devam et'i tıklayın. Test kullanıcıları bölmesi gösterilir.
- Kitle'yi ve + KULLANICI EKLE düğmesini tıklayın.
- Test kullanıcınızın e-posta adresini 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 geri dön'ü tıklayın.
Ayrıntılı bilgi 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 üzere Setting up OAuth 2.0 (OAuth 2.0'ı ayarlama) bölümündeki talimatları uygulayın. Uygulama türünü (yerel/Android uygulaması) belirtmeniz gerekir.
Uygulamayı imzalayarak aldığınız SHA-1 parmak izini, Google Cloud Console Yardım sitesindeki OAuth 2.0 / Yerel uygulamaları ayarlama bölümündeki 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, ardından projeyi çalıştırmak için Projeyi çalıştır'ı tekrar tıklayın. Daha ayrıntılı talimatlar için Android Developers sitesindeki Run apps on a hardware device (Uygulamaları donanım cihazda çalıştırma) başlıklı makaleyi inceleyin.
Mevcut bir OAuth istemciniz varsa
Yayınlanmış bir uygulama için zaten doğrulanmış bir OAuth istemciniz varsa Home API'lerini test etmek için mevcut OAuth istemcinizi kullanabilirsiniz.
Ev API'lerini test etmek ve kullanmak için Google Home Developer Console kaydı gerekmez. 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 noktaları göz önünde bulundurun:
Mevcut bir OAuth istemcisi kullanılırken 100 kullanıcı sınırı vardır. Test kullanıcısı ekleme hakkında bilgi edinmek içinOAuth izin ekranını ayarlayın. OAuth doğrulamadan 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. Bu sınırlama, Developer Console kaydı tamamlandığında kaldırılır.
Developer Console kaydı , uygulamanızı Home API'leriyle güncellemeye hazırlanırken cihaz türü izinlerini OAuth üzerinden kısıtlamaya hazır olduğunuzda onay için gönderilmelidir.
OAuth doğrulaması bekleyen Google Cloud uygulamalarda, doğrulama tamamlanana kadar kullanıcılar 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.