Google Home Test Paketi

Buluttan buluta    Local Home SDK

Google Home Test Suite, akıllı ev Action'ınızı kendiniz test etmenize olanak tanıyan bir web uygulamasıdır. Test Suite, hesabınızla ilişkili cihazlara ve özelliklere göre otomatik olarak test durumları oluşturur ve çalıştırır. Testleri tamamladığınızda test sonuçlarını görüntüleyebilirsiniz.

Test Suite kullanmak ve test sonuçlarınızı sertifika için Google'a göndermek üzere bilgi edinmek istiyorsanız Akıllı ev işlemlerini test etme ve paylaşma sayfasına bakın. Test Suite'nın bu sürümü özellikle geliştirme ve kalite güvencesi için tasarlanmıştır.

Test Suite tarafından yürütülen testler şunları içerir, ancak bunlarla sınırlı değildir:

• Cihazlarınız ve özellikleriniz için Rapor Durumu ve İstek Senkronizasyonu'nun uygulandığını kontrol eder.

• QUERY amacının cihazınızda uygulandığını ve sonuçlarının Report State sonuçlarıyla eşleştiğini doğrular.

Aşağıdaki düğmeyi tıklayarak Test Suite aracını başlatabilirsiniz:

Başlat Test Suite

İşleminizi kendi kendinize test etme

Aşağıdaki bölümde, cihazınızda ve akıllı ev işlemleri projenizde Test Suite nasıl çalıştırılacağı açıklanmaktadır. Test Suite Google Home Graph, Google Assistant cihazlarını inceleyebilmesi ve doğrudan komut gönderebilmesi için oturum açmanızı gerektirir.

İşleminizi kendiniz test etmek için aşağıdaki adımları uygulayın:

1. Web tarayıcınızda Test Suite platformunu açın.

2. Sağ üst köşedeki butonu kullanarak Google'da oturum açın.

3. Proje Ayrıntıları'nı yapılandırın:

   1. Proje kimliği alanına akıllı ev işleminizin proje tanımlayıcısını girin.
   2. İleri'yi tıklayın.

4. Test Ayarları'nı yapılandırın:

   1. Cloud-to-cloud entegrasyonunuzu onaylıyorsanız varsayılan Rapor Durumu/İstek Senkronizasyonu Zaman Aşımı değerini değiştirmeyin. Ancak test için, aracınızın durumu Home Graph'a bildirmesi daha uzun sürüyorsa zaman aşımı değerini değiştirebilirsiniz.

   2. Cloud-to-cloud entegrasyonunuzu onaylıyorsanız, Test İsteği Senkronizasyonu seçeneğinin etkinleştirildiğinden emin olun; test sırasında bir cihaz eklemeniz, güncellemeniz veya kaldırmanız ve Ana Grafik'teki cihaz listesinin değişip değişmediğini kontrol etmeniz istenecektir. Değişiklik eylemleri test ettiğiniz entegrasyon üzerinden gerçekleşir. Test edilen entegrasyonunuzda her zaman temsilci kullanıcısına bağlı en az bir cihaz olmalıdır.

   3. Scene özelliğini kullanıyorsanız Test Sahnesi özelliğini seçin.

   4. Test paketini Yerel Ev aygıtları için çalıştırıyorsanız Yerel Ev SDK'sını Destekler seçeneğini belirleyin.

      1. Yerel Teslimat veya Sorunsuz Kurulum'u seçin.
      2. Cihaz, QUERY amacını yerel olarak işleyebiliyorsa Yerel Sorguyu Destekler'i tıklayın.

5. Test çalıştırması gerçekleştirin ve sonuçları görüntüleyin:

   1. Testleri çalıştırmaya başlamak için İleri'yi tıklayın. Arayüzde, test edilen cihazlar ve özellikler gösterilir.

6. Sonuçlar ve Gönderim sayfasını görüntüleyin:

   1. Testler tamamlandıktan sonra sonuçları görüntülemek için Sonraki'yi tıklayın.

Test sonuçları, başarılı ve başarısız testlerin sayısını ve başarılı testlerin yüzdesini gösteren nihai bir puanı içerir.

Hesap bağlantı doğrulama testi

Hesap bağlama, Google akıllı ev ekosisteminde önemli bir rol oynar. Test Suite içindeki hesap bağlama doğrulama testi, OAuth servisinizi olası sorunlar açısından kontrol eder.

Hesap bağlama doğrulama testi, erişim jetonlarını ve yenileme jetonlarını doğrulayan testler içerir:

Erişim belirteci doğrulama testi

Jeton değişimi uç noktanızdan döndürülen erişim jetonları, geçerli bir biçime sahip olduklarından ve geçerli bir yenileme jetonuyla döndürüldüklerinden emin olmak için test edilir.

Test Öğeleri	Açıklama
Erişim belirtecinin JWT biçiminde olup olmadığını kontrol edin	Google Hesap bağlantısı JWT formatındaki erişim belirteçlerini önermez. JWT biçimi bulunursa aşağıdaki uyarı gösterilir: The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
Geçerliliği dolan erişim jetonunun yenileme jetonu olup olmadığını kontrol edin.	Erişim jetonunun süresi dolduğunda yeni kod sağlanmalıdır. Yenileme jetonu bulunamazsa bu test başarısız olur.

Yenileme jetonu doğrulama testi

Jeton değişimi uç noktanızın, yenileme jetonlarını yeni erişim jetonlarıyla doğru şekilde değiştirdiğinden emin olmak için yenileme jetonları test edilir.

Test Öğeleri	Açıklama
Geçersiz yenileme jetonuyla yenileme jetonu. İş ortağı yanıtı kontrol ediliyor.	Sunucunuz, geçersiz bir yenileme jetonu isteğine {"error": "invalid_grant"} ile birlikte bir HTTP 400 Bad Request hatası döndürmelidir. Eğer yanıt "hata kodu veya mesajı" ile uyuşmuyorsa, bu test vakası başarısız olacaktır. Daha fazla bilgi için erişim belirteçleri için yenileme belirteçlerini değiştirme sayfasını ziyaret edin.
Erişim jetonunun, jeton yenileme işleminden sonra güncellenip güncellenmediğini test edin.	Yenileme belirteci isteklerine yanıt olarak yeni erişim belirteçleri döndürülmelidir. Sunucunuz aynı erişim belirtecini sağlıyorsa test vakası başarısız olacaktır.
Süresi dolmamış erişim belirtecinin hala geçerli olup olmadığını kontrol edin.	Erişim jetonunun geçerlilik bitiş zamanı gösterilir.
Yenileme sırasında yenileme jetonunun döndürülüp döndürülmediğini kontrol edin.	Yenileme jetonu isteğinden sonra yenileme jetonlarının değiştirilip değiştirilmediğini kontrol ederiz. Yenileme jetonu değişirse sunucunuz, kullanıcının hesap bağlantısını bozabilecek yarış koşullarını önlemek için eski yenileme jetonunu yalnızca yeni bir yenileme jetonu kullanıldıktan sonra geçersiz kılmalıdır. Yeni yenileme belirtecini kullanmadan önce eski yenileme belirtecini geçersiz kılarsanız test başarısız olur.

Hata mesajları

Aşağıdaki tabloda, karşılaşabileceğiniz bazı yaygın hata mesajları ve bunları çözmek için önerilen yöntemler listelenmiştir.

Hata Mesajı	Çözüm
HomeGraph API, <_id_> kimlikli projede daha önce kullanılmadı veya devre dışı bırakıldı.	HomeGraph API'yi etkinleştirdiğinizden emin olun.
İstenen tüzel kişi bulunamadı	agentUserId numaranızın geçerli olduğunu ve hizmetinize bağlı olduğunu kontrol edin.
resourcemanager.projects.get izninizin ${your project id} projesinde olduğundan ve izin ekranında tüm izinleri verdiğinizden emin olun. Modül verileri alınırken hata oluştu: getModuleData error: Http failure response for https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403	Hesabınızın proje için resourcemanager.projects.get izinlerine sahip olduğundan emin olmak için IAM izinleriyle ilgili sorunları giderme bölümündeki talimatları uygulayın. Hesabınıza erişimi olan uygulamalar sayfasına giderek "Akıllı ev için test paketi"nin aşağıdaki izinlerini kontrol edin: Temel hesap bilgileri Birincil Google Hesabı e-posta adresinizi görün Herkese açık olarak sunduklarınız da dahil olmak üzere kişisel bilgilerinizi görme Ek erişim Assistant cihazınızı kullanma: Google Hesabınıza geniş erişim Home Graph'teki akıllı ev cihazlarını denetleyip kontrol etme İzin hatası alırsanız önce erişimi kaldırın ve tekrar oturum açtığınızda izin verme ekranında tüm izinleri verin.

Test sonuçlarını gönderme

Test Suite sonuçlarınızın sertifikasyona gönderilmeden önce testlerin% 100'ünü geçmesi gerekir. Manuel test gerektiren özellikleriniz varsa Test Suite aracını çalıştırmanız ve sonuç %100 geçmemiş olsa bile sonucu eklemeniz gerekir.

Test sonuçlarınızı göndermek ve Cloud-to-cloud entegrasyonunuzu onaylamak için aşağıdaki adımları uygulayın:

1. Test sonuçlarınızı aldıktan ve Cloud-to-cloud entegrasyonunuzu onaylamaya hazır olduğunuzda, Test Suite aracında Gönder'e tıklayın.
2. Google Home Developer Console > Cloud-to-cloud > Certify'a (Sertifika) gidin.
3. Sertifikalandırmak istediğiniz entegrasyonu seçin.
4. Belgeler bölümüne Test Suite sonuç kimliğinizi girin.

5. Gerekli tüm alanları doldurun ve ardından Gönder'e tıklayın.