Google Home Test Paketi

Buluttan buluta    Local Home SDK

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şkili cihazlara ve özelliklere göre test durumlarını otomatik olarak oluşturur ve çalıştırır. Testleri tamamladığınızda test sonuçlarını görüntüleyebilirsiniz.

Test Suite aracını kullanmak ve test sonuçlarınızı sertifika için Google'a göndermek istiyorsanız Akıllı ev İşlemlerini test etme ve paylaşma sayfasındaki bilgilere göz atın. Test Suite uygulamasının bu sürümü, özellikle geliştirme ve kalite kontrolü için tasarlanmıştır.

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

• Cihazlarınız ve özellikleriniz için Report State ve Request Sync özelliklerinin uygulanıp uygulanmadığını kontrol eder.

• QUERY intent'inin cihazınız için 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, Test Suite uygulamasını cihazınızda ve akıllı ev Action projenizde nasıl çalıştıracağınız açıklanmaktadır. Test Suite, Google Home Graph içindeki cihazları inceleyebilmek ve doğrudan Google Assistant uygulamasına komut 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 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. Project ID (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 Report State/Request Sync Zaman Aşımı değerini değiştirmeyin. Ancak test için, temsilcinizin Home Graph'e durumu bildirmesi daha uzun sürüyorsa zaman aşımı değerini değiştirebilirsiniz.

   2. Cloud-to-cloud entegrasyonunuzu sertifikalandırıyorsanız Test Request Sync (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 üzerinden gerçekleştirilir. Test edilen entegrasyonunuzda her zaman temsilci kullanıcıya bağlı en az bir cihaz olmalıdır.

   3. Scene özelliğini kullanıyorsanız Test Sahnesi özelliği'ni 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 Karşılama veya Kolay Kurulum'u seçin.
      2. Cihaz, QUERY intent'ini 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 İleri'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ğ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 hizmetinizi olası sorunlar açısından 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ç 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ğlantısı, JWT biçimindeki erişim jetonları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 dolabilen erişim jetonunun yenileme jetonu olup olmadığını kontrol edin.	Erişim jetonunun süresi dolabiliyorsa bir 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şim 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
Geçersiz yenileme jetonuyla yenileme jetonu, iş ortağı yanıtı kontrol ediliyor.	Sunucunuz, geçersiz bir 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 yenileme jetonlarını erişim jetonlarıyla değiştirme başlıklı makaleyi inceleyin.
Jeton yenileme işleminden 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 süre sonu gösterilir.
Yenileme sırasında yenileme jetonunun değiştirilip değiştirilmediğini kontrol edin.	Yenileme jetonu isteğinden sonra yenileme jetonlarının değişip değişmediğini kontrol ederiz. Yenileme jetonu değişirse sunucunuz, kullanıcının hesap bağlantısını bozabilecek yarışma durumlarını önlemek için yalnızca yeni bir yenileme jetonu kullanıldıktan sonra eski 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ı çö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 değerinizin geçerli ve hizmetinize bağlı olduğundan emin olun.
${your project id} projesinde resourcemanager.projects.get iznine sahip olduğunuzdan ve kullanıcı rızası 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 için HTTP hata 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 bölümündeki talimatları uygulayın. "Akıllı ev için test paketi"nin aşağıdaki izinlerini kontrol etmek için 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 sunduklarınız da dahil olmak üzere kişisel bilgilerinizi görme Ek erişim Assistant uygulamanızı kullanma: Google Hesabınıza geniş erişim Home Graph'inizdeki akıllı ev cihazlarını inceleme ve kontrol etme İzin hatası alırsanız önce erişimi kaldırın ve tekrar oturum açtığınızda kullanıcı rızası ekranında tüm izinleri verin.

Test sonuçlarını gönderme

Sertifika için 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ırmanız ve %100 başarılı olmasa 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 olduktan sonra Test Suite aracında Gönder'i tıklayın.
2. Google Home Developer Console > Cloud-to-cloud > Sertifika ver'e gidin.
3. Sertifika almak istediğiniz entegrasyonu seçin.
4. Belgeler bölümünde Test Suite sonuç kimliğinizi girin.

5. Tüm zorunlu alanları doldurun ve Gönder'i tıklayın.