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 göstermek zorunda kalmadan bir uygulamaya veya hizmete izin vermesine olanak tanır.
Doğrulanmış bir OAuth istemciniz varsa (ör. daha önce yayınlanmış bir uygulamadan) yeni bir istemci oluşturmadan Home API'lerini test etmek için bu istemciyi kullanabilirsiniz. Daha fazla bilgi için Mevcut bir OAuth istemciniz varsa bölümüne bakın.
Uygulamayı imzalama
Öncelikle, uygulamanızı Android Studio'te çalıştırarak bir OAuth anahtarı oluşturun. Android Studio'te bir uygulamayı çalıştırdığınızda veya uygulamada hata ayıklama yaptığınızda, geliştirme ve hata ayıklama için otomatik olarak bir OAuth anahtarı oluşturulur. Tam açıklama için Android Studio: Hata ayıklama derlemenizi imzalama başlıklı makaleyi inceleyin.
Uygulama çalışırken:
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ı oluşturup mobil cihazınıza yükler.
Daha ayrıntılı talimatlar için Android Developers sitesinde Donanım cihazında uygulama çalıştırma başlıklı makaleyi inceleyin.
Çalışan uygulamayı durdurun.
Google Cloud Console Yardım sitesindeki OAuth 2.0'ı ayarlama / Yerel uygulamalar / Android bölümünde ayrıntılı olarak açıklanan talimatları uygulayarak OAuth 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 gidin ve 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, izin ekranınızı aşağıdaki prosedürü kullanarak yapılandırın. Aksi takdirde bir sonraki bölüme geçin.
- İzin 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 ardından 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örüntülenir.
- Herhangi bir kapsam eklemeniz gerekmez. Kaydet ve devam et'i tıklayın. Test kullanıcıları bölmesi gösterilir.
- Uygulamanıza erişimi test etmek için kullanıcı eklemek istiyorsanız Kullanıcı ekle'yi tıklayın. Kullanıcı ekle bölmesi gösterilir. Test kullanıcıları, uygulamanızda izin verme ayrıcalığına sahiptir.
- Boş alana bir veya daha fazla Google Hesabı e-posta adresi ekleyin ve ardından Ekle'yi tıklayın.
- Kaydet ve devam et'i tıklayın. Özet bölmesi gösterilir.
- OAuth izin ekranı bilgilerinizi inceleyin ve ardından Kontrol paneline 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'a kaydettirmek ve OAuth kimlik bilgileri oluşturmak için OAuth 2.0 kurulumu başlıklı makalede verilen talimatları uygulayın. Uygulama türünü (yerel/Android uygulaması) belirtmeniz gerekir.
Uygulamayı imzalarken aldığınız SHA-1 parmak izini, Google Cloud Console Yardım sitesindeki OAuth 2.0 / Yerel uygulamaları ayarlama başlıklı makaledeki talimatları uygulayarak Google Cloud Console'da oluşturduğunuz OAuth istemciye ekleyin.
Mobil cihazınız yerel makinenize bağlıyken listeden cihazınızı seçin ve ardından Projeyi çalıştır'ı tekrar tıklayarak projeyi çalıştırın. Daha ayrıntılı talimatlar için Android Developers sitesinde Donanım cihazında uygulama ç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ına ihtiyacınız vardır.
Aşağıdaki noktalar dikkate alınmalıdır:
Mevcut bir OAuth istemcisi kullanırken 100 kullanıcı sınırı vardır. Test kullanıcıları ekleme hakkında bilgi edinmek için OAuth izin ekranını ayarlama başlıklı makaleyi inceleyin. OAuth doğrulamasından bağımsız olarak, uygulamanıza izin verebilecek 100 kullanıcıyla sınırlı bir Home API'si sınırı vardır. Bu sınırlama, Developer Console kaydı tamamlandıktan sonra kaldırılır.
Developer Console registration , uygulamanızı Home API'lerle güncellemeye hazırlanırken OAuth üzerinden cihaz türü izinlerini kısıtlamaya hazır olduğunuzda onay için gönderilmelidir.
OAuth doğrulaması beklemede olan Google Cloud uygulamaları için kullanıcılar, doğrulama tamamlanana kadar OAuth akışını tamamlayamaz. İzin verme denemeleri aşağıdaki hatayla başarısız olur:
Access blocked: <Project Name> has not completed the Google verification process.