Google Home Test Paketi

Cloud-to-cloud    Local Home SDK

Google Home Test Suite, akıllı ev işleminizi kendi başınıza test etmenize olanak tanıyan bir web uygulamasıdır. Test Suite, hesabınızla ilişkilendirilmiş 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üleyebilir veya test sonuçlarını Google'a göndermek için gönderim formunu doldurabilirsiniz.

Test Suite tarafından gerçekleştirilen testler aşağıdakileri içerir, ancak bunlarla sınırlı değildir:

  • Cihazlarınız ve özellikleriniz için Rapor Durumu ve Senkronizasyon İste seçeneğinin uygulandığını kontrol eder.

  • QUERY amacının 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 uygulamasını başlat

İşleminizi kendi kendinize test etme

Aşağıdaki bölümde, cihazınızda ve akıllı evinizin İşlem projesinde Test Suite işlemini nasıl çalıştıracağınız açıklanmaktadır. Test Suite, Google Home Graph cihazınızdaki cihazları inceleyebilmesi ve komutları doğrudan Google Assistant adresine gönderebilmesi için oturum açmanızı gerektirir.

İşleminizi kendi kendinize test etmek için şu adımları uygulayın:

  1. Web tarayıcınızda Test Suite sayfasını 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 İşleminizin proje tanımlayıcısını girin.
    2. İleri'yi tıklayın.
  4. Test Ayarları'nı yapılandırın:

    1. Akıllı ev İşleminizi onaylıyorsanız varsayılan Rapor Durumu/İstek Senkronizasyon Zaman Aşımı değerini değiştirmeyin. Ancak, aracınızın durumu Home Graph'e bildirmesi daha uzun sürerse test için zaman aşımı değerini değiştirebilirsiniz.
    2. Akıllı ev İşleminizi onaylıyorsanız Senkronizasyon İsteğini Test Et seçeneğinin etkinleştirildiğinden emin olun. Test sırasında, bir cihaz eklemeniz, güncellemeniz veya kaldırmanız ve Home Graph'te cihaz listesinin değişip değişmediğini kontrol etmeniz istenir. Değişiklik işlemleri, test ettiğiniz entegrasyon aracılığıyla gerçekleşir. Test kapsamındaki entegrasyonunuzda her zaman aracı kullanıcıya bağlı en az bir cihaz olmalıdır.

    3. Scene özelliği kullanıyorsanız Sahne özelliğini test et'i seçin.

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

      1. Yerel sipariş karşılama veya Kolay kurulum'u seçin.
      2. Cihaz, QUERY amacını yerel olarak işleyebiliyorsa Local Query'yi (Yerel Sorguyu Destekler) tıklayın.
  5. Bir Test Çalıştırma 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üz, test edilen cihazları ve özellikleri gösteriyor.
  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ı, geçilen ve başarısız olan test sayısının yanı sıra başarılı olma yüzdesini belirten son bir puanı içerir.

Hesap bağlama doğrulama testi

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

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

Erişim jetonu doğrulama testi

Jeton değişimi uç noktasından 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 edin Google Hesabı bağlama özelliği, JWT biçimindeki erişim jetonlarını önermez. 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 jetonunun yenileme jetonu olup olmadığını kontrol edin. Erişim jetonunun süresi dolarsa, 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 bu jetonları yeni erişim jetonlarıyla düzgün şekilde değiştirdiğinden emin olmak için test edilir.

Test Öğeleri Açıklama
Yenileme jetonu geçersiz yenileme jetonuyla, iş ortağı yanıtı kontrol ediliyor. Sunucunuzun, geçersiz bir yenileme jetonu isteği için {"error": "invalid_grant"} ile birlikte HTTP 400 Hatalı İstek hatası döndürmesi gerekir. 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ı değişimi sayfasını ziyaret edin.
Jeton yenilemesinden sonra erişim jetonunun güncellenip güncellenmediğini test edin. Yeni erişim jetonları, yenileme jetonu isteklerine yanıt olarak döndürülmelidir. Sunucunuz aynı erişim jetonunu sağlıyorsa test durumu başarısız olur.
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ğ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 iptal etmelidir. Eski yenileme jetonunu yenisi kullanılmadan önce 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_> projesinde daha önce kullanılmadı veya devre dışı bırakıldı HomeGraph API'yi etkinleştirdiğinizden emin olun.
İstenen Varlık bulunamadı agentUserId öğenizin geçerli ve hizmetinize bağlı olduğundan emin olun.

${your project id} projesinde resourcemanager.projects.get izninizin olduğundan ve izin ekranındaki 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: 403 OK 403 için HTTP hatası yanıtı

  1. 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.
  2. "Akıllı ev için test paketi" ile ilgili aşağıdaki izinleri kontrol etmek üzere Hesabınıza erişimi olan uygulamalar sayfasına gidin:
    • Temel hesap bilgileri
      1. Birincil Google Hesabı e-posta adresinizi görün
      2. Herkese açık olarak sunduğunuz tüm kişisel bilgiler de dahil olmak üzere kişisel bilgilerinizi görme
    • Ek erişim
      1. Assistant: Google Hesabınıza geniş kapsamlı erişim
      2. Ev Grafiğinizdeki akıllı ev cihazlarını denetleyip kontrol edin
    İ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 testlerin% 100'ünü geçmelidir. Manuel test yapılmasını gerektiren özellikleriniz varsa yine de Test Suite aracını çalıştırmanız ve %100'e geçmemiş olsa bile sonucu eklemeniz gerekir.

Test sonuçlarınızı göndermek ve akıllı ev işleminizi onaylamak için aşağıdaki adımları uygulayın:

  1. Test sonuçlarınızı aldıktan ve akıllı ev işleminizi 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ÖNDERİM FORMUNA GİT'i tıklayın.
  4. Zorunlu alanların tümünü doldurun, ardından Gönder'i tıklayın.