Google Home Test Paketi

Google Home Test Suite, akıllı ev İşleminizi kendi kendinize test etmenize olanak tanıyan bir web uygulamasıdır. Test Suite, hesabınızla ilişkilendirilen 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 yürütülen 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ği'nin uygulanıp uygulanmadığını kontrol eder.

  • QUERY amacının cihazınızda 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 kendine test etme

Aşağıdaki bölümde, Test Suite uygulamasını cihazınızda ve akıllı ev İşlem projenizde nasıl çalıştıracağınız açıklanmaktadır. Test Suite, Google Home Graph cihazınızdaki cihazları inceleyebilmek ve komutları doğrudan Google Assistant ürününe gönderebilmek için oturum açmanızı gerektirir.

İşleminizi kendi kendinize test etmek için aşağıdaki 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 Senkronizasyonu Zaman Aşımı değerini değiştirmeden bırakın. Ancak, aracınızın durumu Ana Sayfa Grafiği'ne bildirmesi daha uzun sürüyorsa test sırasında zaman aşımı değerini değiştirebilirsiniz.
    2. Akıllı ev İşleminizi 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'te cihaz listesinin değişip değişmediğini kontrol etmeniz istenir. Değişiklik işlemleri, test ettiğiniz entegrasyon üzerinden gerçekleştirilir. Test edilen entegrasyonunuzda, temsilci kullanıcıya her zaman en az bir cihaz bağlı olmalıdır.

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

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

      1. Yerel Sipariş Karşılama veya Sorunsuz Kurulum'u seçin.
      2. Cihaz, QUERY amacını yerel olarak işleyebiliyorsa Yerel Sorguyu Destekler'i tıklayın.
  5. Bir 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ı, geçilen ve başarısız olan testlerin sayısının yanı sıra geçmelerin yüzdesini belirten son puanı içerir.

Hesap bağlama 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 hizmetinizi olası sorunlara karşı 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 testine

Jeton değişimi uç noktanızdan döndürülen erişim jetonlarının geçerli bir biçime sahip olduğundan ve geçerli bir yenileme jetonuyla döndürüldüğünden 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 işlemi, JWT biçimindeki erişim jetonlarının kullanılmasını ö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.
Süresi dolan erişim jetonunun yenileme jetonu olup olmadığını kontrol edin. Erişim jetonunun süresi dolabilir olduğunda bir yenileme jetonu sağlanmalıdır. Yenileme jetonu bulunmazsa bu test başarısız olur.

Jeton doğrulama testini yenile

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
Jetonu geçersiz yenileme jetonuyla yenileme (iş ortağı yanıtının kontrolü). Sunucunuz, geçersiz bir yenileme jetonu isteğine {"error": "invalid_grant"} ile bir HTTP 400 Hatalı İstek hatası döndürmelidir. Yanıt, "hata kodu veya mesajı" ile eşleşmiyorsa bu test durumu başarısız olur. Daha fazla bilgi için erişim jetonlarıyla yenileme jetonlarını takas etme 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ğlarsa 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 sona erme 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 sunucunuzun, kullanıcının hesap bağlamasını bozabilecek yarış koşullarını önlemek için yalnızca yeni bir yenileme jetonu kullanıldıktan sonra eski yenileme jetonunu geçersiz kılması gerekir. 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ı çözmenin önerilen yolları listelenmiştir.

Hata Mesajı Nasıl Çözülür?
Home Graph API daha önce <_id_> projesinde kullanılmadı veya devre dışı bırakıldı HomeGraph API'yi etkinleştirdiğinizden emin olun.
İstenen varlık bulunamadı agentUserId öğenizin geçerli olduğundan ve hizmetinize bağlı olduğundan emin olun.

${your project id} projesi için resourcemanager.projects.get izniniz olduğundan ve izin ekranındaki tüm izinleri verdiğinizden emin olun.

Modül verileri alınırken hata oluştu: getModuleData error: https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 için HTTP hata yanıtı

  1. Hesabınızda proje için resourcemanager.projects.get izinlerine sahip olduğundan emin olmak amacıyla IAM izinleriyle ilgili sorunları giderme başlıklı makaledeki talimatları uygulayın.
  2. Hesabınıza erişimi olan uygulamalar sayfasına giderek "Akıllı ev için test paketi" ile ilgili aşağıdaki izinleri kontrol edin:
    • 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 kullanın: Google Hesabınıza geniş erişim
      2. Home Graph'teki 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önder

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

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

  1. Test sonuçlarınızı aldıktan ve akıllı ev İş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. Gerekli alanların tümünü doldurup Gönder'i tıklayın.