Google Home Test Paketi

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Buluttan buluta Yerel Ev 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ı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ü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 özelliklerinin uygulanıp uygulanmadığını kontrol eder.

  • QUERY niyetinin 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

Test Suite uygulaması, cihazınızda ve akıllı ev Action projenizde nasıl çalıştırılacağı açıklanmaktadır. Test Suite, Google Home Graph cihazınızda cihazları inceleyebilmesi ve doğrudan Google Assistant öğesine 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 uygulaması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 Action'ınızın 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 Action'ınızı doğruluyorsanız varsayılan Report State/Request Sync Timeout (Rapor Durumu/İstek Senkronizasyonu Zaman Aşımı) değerini değiştirmeden bırakın. Ancak test için temsilcinizin Home Graph'e durumu bildirmesi daha uzun sürüyorsa zaman aşımı değerini değiştirebilirsiniz.
    2. Akıllı evinizdeki İşlemi onaylarsanı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 istenir. Ardından, Home Graph'te cihaz listesinin değişip değişmediğini kontrol edin. Değişiklik işlemleri, test ettiğiniz entegrasyon üzerinden gerçekleştirilir. Test edilen entegrasyonunuzda temsilci kullanıcısına her zaman en az bir cihaz bulunmalıdır.

    3. Sahne özelliğini kullanıyorsanız Sahne özelliğini test etme'yi seçin.

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

      1. Yerel Sipariş Karşılama veya Sorunsuz Kurulum'u seçin.
      2. Cihaz QUERY amacını yerel olarak işleyebilirse Yerel Sorguyu Destekler'i tıklayın.
  5. Bir Test Çalıştır 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üz, test edilen cihazları ve özellikleri gösterir.
  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 İleri'yi tıklayın.

Test sonuçlarında, başarılı ve başarısız olan test sayısı ile denemelerin yüzdesini belirten son puan bulunur.

Hesap bağlama doğrulama testi

Hesap bağlama, Google akıllı ev ekosisteminde önemli bir rol oynar. Test Suite hesabındaki hesap bağlama doğrulaması testi, OAuth hizmetinizi olası sorunlar için 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ükten sonra test edilir.

Test Öğeleri Açıklama
Erişim jetonunun JWT biçiminde olup olmadığını kontrol edin Google hesabı bağlama, JWT biçiminde erişim jetonları ö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 dolduğ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 exchange uç noktanızın yeni erişim jetonlarıyla düzgün şekilde takas edildiğinden emin olmak için test edilir.

Test Öğeleri Açıklama
Jetonu geçersiz yenileme jetonuyla yenileyerek iş ortağı yanıtını kontrol edin. Sunucunuz, geçersiz yenileme jetonu isteğine {"error": "invalid_grant"} ile birlikte 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 sayfasını ziyaret edin.
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 geçerlilik süresi gösterilir.
Yenileme sırasında yenileme jetonunun döndürülüp döndürülmediğini kontrol edin. Yenileme jetonları, yenileme jetonu isteğinden sonra değiştirilip değiştirilmediğini kontrol ederiz. Yenileme jetonu değişirse kullanıcının hesap bağlama işlemini kesintiye uğratabilecek yarış koşullarını önlemek için yalnızca yeni bir yenileme jetonu kullanıldıktan sonra sunucunuz eski bir yenileme jetonunu geçersiz kılmalıdır. Yeni yenileme jetonu 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 yolları önerilir.

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 Varlık 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 izniniz olduğundan ve izin ekranındaki tüm izinleri verdiğinizden emin olun.
  1. Hesabınızın proje için resourcemanager.projects.get izinlerine sahip olduğundan emin olmak üzere IAM izinleriyle ilgili sorunları giderme talimatlarını uygulayın.
  2. "Akıllı ev için test paketi" ile ilgili aşağıdaki izinleri kontrol etmek için 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 sunduklarınız da dahil olmak üzere kişisel bilgilerinizi görme
    • Ek erişim
      1. Assistant hesabınızı kullanın: Google hesabınıza geniş erişim
      2. Home Graph'teki akıllı ev cihazlarını denetleyip kontrol etme
    Eksikse önce erişimi kaldırın ve tekrar giriş yaparken izin ekranındaki tüm izinleri verin.

Test sonuçlarını gönderme

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

Test sonuçlarınızı göndermek ve akıllı ev Action'ınızı 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. Gerekli alanların tümünü doldurun, ardından Gönder'i tıklayın.