Google Home Test Paketi

Buluttan buluta    Yerel Home SDK'sı

Google Home Test Suite, akıllı ev Action'ınızı kendi kendinize test etmenize olanak tanıyan bir web uygulamasıdır. Test Suite, hesabınıza bağlı cihazlara ve özelliklere göre test durumlarını otomatik olarak oluşturup ç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 istiyorsanız bilgi için Akıllı ev işlemlerini test etme ve paylaşma sayfasına bakın. Test Suite'ün bu sürümü özellikle geliştirme ve kalite güvencesi içindir.

Test Suite tarafından yürütülen testler aşağıdakileri kapsar ancak bunlarla sınırlı değildir:

• Cihazlarınız ve özellikleriniz için Durum Bildir ve İstek Senkronizasyonu'nun uygulanıp uygulanmadığını kontrol eder.

• QUERY intent'inin cihazınız için uygulandığını ve sonuçlarının Rapor Durumu sonuçlarıyla eşleştiğini doğrular.

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

Test Suite'u başlatın

İşleminizi kendi kendinize test etme

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

İşlevinizi kendi kendinize 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 düğmeyi 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, temsilcinizin durumu Home Graph'a bildirmesi daha uzun süre alıyorsa test için 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 Home Graph'ta cihaz listesinin değişip değişmediğini kontrol etmeniz istenir. Değişiklik işlemleri, test ettiğiniz entegrasyon üzerinden gerçekleşir. Test edilen entegrasyonunuzda, temsilci kullanıcısına her zaman en az bir cihaz bağlı olmalıdır.

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

   4. Yerel Ev cihazları için test paketini çalıştırıyorsanız Yerel Ev SDK'sını destekler'i seçin.

      1. Yerel Siparişin Yerine Getirilmesi veya Sorunsuz Kurulum'u seçin.
      2. Cihaz QUERY intent'ini yerel olarak işleyebiliyorsa Yerel Sorguyu Destekler'i tıklayın.

5. Test çalıştırma işlemi 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ığında sonuçları görüntülemek için İleri'yi tıklayın.

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

Hesap bağlama doğrulama testi

Hesap bağlama, Google akıllı ev ekosisteminde önemli bir rol oynar. Test Suite'teki hesap bağlama doğrulama testi, OAuth hizmetinizde olası sorunları kontrol eder.

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

Erişim jetonu 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 jetonunun JWT biçiminde olup olmadığını kontrol etme	Google Hesabı bağlama işleminde JWT biçimli erişim jetonları önerilmez. JWT biçimi bulunursa şu 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.
Süresi dolan erişim jetonunda yenileme jetonu olup olmadığını kontrol edin.	Erişim jetonunun süresi dolabiliyorsa yenileme jetonu sağlanmalıdır. Yenileme jetonu bulunamazsa bu test başarısız olur.

Yenileme jetonu doğrulama testi

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

Test Öğeleri	Açıklama
İş ortağı yanıtını kontrol ederken geçersiz yenileme jetonuyla yenileme jetonu.	Sunucunuz, geçersiz bir yenileme jetonu isteği için {"error": "invalid_grant"} ile HTTP 400 Hatalı İstek hatası döndürmelidir. Yanıt, "hata kodu veya mesaj" ile eşleşmezse bu test durumu başarısız olur. Daha fazla bilgi için erişim jetonları için yenileme jetonlarını değiştirme başlıklı makaleyi inceleyin.
Jeton yenilendikten sonra erişim jetonunun güncellenip güncellenmediğini test edin.	Yenileme jetonu isteklerine yanıt olarak yeni erişim jetonları döndürülmelidir. Sunucunuz aynı erişim jetonunu sağlıyorsa test senaryosu başarısız olur.
Geçerlilik süresi dolmamış erişim jetonunun hâlâ 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ği sonrasında 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 bir yenileme jetonunu yalnızca yeni bir yenileme jetonu kullanıldıktan sonra geçersiz kılmalıdır. Yenisi kullanılmadan önce eski yenileme jetonunu 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ın çözümü için önerilen yöntemler listelenmiştir.

Hata Mesajı	Çözüm
HomeGraph API, <_id_> projesinde daha önce kullanılmadı veya devre dışı bırakıldı	HomeGraph API'yi etkinleştirdiğinizden emin olun.
İstenen öğe bulunamadı	agentUserId cihazınızın geçerli olduğundan ve hizmetinize bağlı olduğundan emin olun.
${your project id} projesinde resourcemanager.projects.get iznine sahip olduğunuzdan ve izin ekranında tüm izinleri verdiğinizden emin olun. Modül verileri alınırken hata oluştu: getModuleData hatası: https://hometestsuiteproxy-pa.googleapis.com/v1/module:get için Http hatası yanıtı: 403 OK 403	Hesabınızın proje için resourcemanager.projects.get izinlerine sahip olduğundan emin olmak üzere IAM izinleriyle ilgili sorunları giderme başlıklı makaledeki talimatları uygulayın. "Akıllı ev için test paketi"nin aşağıdaki izinlerini kontrol etmek üzere Hesabınıza erişimi olan uygulamalar sayfasına gidin: Temel hesap bilgileri Birincil Google Hesabı e-posta adresinizi görün Herkese açık olarak sunduğunuz tüm kişisel bilgileriniz de dahil olmak üzere kişisel bilgilerinizi görme Ek erişim Assistant'inizi 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 giriş yaptığınızda izin ekranında tüm izinleri verin.

Test sonuçlarını gönderme

Sertifika formunuzu göndermeden önce Test Suite sonuçlarınızın testlerin% 100'ünü geçmesi gerekir. Manuel test gerektiren özellikleriniz varsa Test Suite aracını çalıştırıp sonucu eklemeniz gerekir. Sonuç %100 başarılı olmasa bile bunu yapmanız gerekir.

Test sonuçlarınızı göndermek ve Cloud-to-cloud integrasyonunuzu 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'i tıklayın.
2. Test sonuçlarınızı almak için TEST SONUÇLARINI İNDİR düğmesini tıklayın.
3. Test sonuçlarını Google'a göndermek için GÖNDERME FORMUNU GÖSTER'i tıklayın.

4. Gerekli tüm alanları doldurun ve Gönder'i tıklayın.