Google Home Test Suite,

Google Home Test Suite to aplikacja internetowa, która pozwala samodzielnie przetestować działanie inteligentnego domu. Test Suite automatycznie generuje i uruchamia zgłoszenia testowe na podstawie urządzeń i cech powiązanych z Twoim kontem. Po zakończeniu testów możesz wyświetlić ich wyniki lub wypełnić formularz, aby przesłać wyniki do Google.

Testy wykonywane przez Test Suite to między innymi:

• Sprawdza, czy na Twoich urządzeniach i ich cechach zostały wdrożone stan raportowania i żądanie synchronizacji.

• Sprawdza, czy intencja QUERY została zaimplementowana na urządzeniu i jej wyniki pasują do wyników w raporcie Stan.

Aby uruchomić narzędzie Test Suite, kliknij przycisk poniżej:

Uruchom: Test Suite

Sprawdź swoje działanie

Z tej sekcji dowiesz się, jak uruchomić Test Suite na urządzeniu i w projekcie Smart Home. Test Suite wymaga zalogowania się, dzięki czemu może sprawdzać urządzenia w: Google Home Graph i wysyłać polecenia bezpośrednio do Google Assistant.

Aby samodzielnie przetestować akcję, wykonaj te czynności:

1. W przeglądarce otwórz Test Suite.

2. Zaloguj się w Google za pomocą przycisku w prawym górnym rogu.

3. Skonfiguruj szczegóły projektu:

   1. W polu Identyfikator projektu wpisz identyfikator projektu inteligentnego domu.
   2. Kliknij Dalej.

4. Skonfiguruj ustawienia testu:

   1. Jeśli poświadczasz działanie w inteligentnym domu, nie zmieniaj wartości domyślnej Stan raportu/Limit czasu żądania synchronizacji. Jednak aby przeprowadzić test, możesz zmienić wartość czasu oczekiwania, jeśli agent potrzebuje więcej czasu na raportowanie stanu do wykresu z Home Home.

   2. Jeśli certyfikujesz działanie inteligentnego działania domowego, upewnij się, że opcja Testowa synchronizacja żądań jest włączona. Podczas testowania pojawi się prośba o dodanie, zaktualizowanie lub usunięcie urządzenia i sprawdzenie, czy lista urządzeń zmieniła się na wykresie domowym. Działania powodujące zmianę są wprowadzane w testowanej integracji. Integracja, która będzie testowana, musi zawsze mieć co najmniej 1 urządzenie połączone z użytkownikiem agenta.

   3. Jeśli korzystasz z cechy Sceny, wybierz Testuj scenę.

   4. Jeśli korzystasz z pakietu testowego dla urządzeń w lokalnym domu, wybierz Obsługuje lokalny pakiet SDK dla domu.

      1. Wybierz Lokalna realizacja lub Płynna konfiguracja.
      2. Jeśli urządzenie obsługuje lokalną intencję QUERY, kliknij Obsługuje zapytanie lokalne.

5. Wykonaj test i wyświetl wyniki:

   1. Kliknij Dalej, aby rozpocząć testy. Interfejs pokazuje urządzenia i cechy, które chcesz przetestować.

6. Wyświetl stronę Wyniki i przesyłanie:

   1. Po zakończeniu testów kliknij Dalej, aby wyświetlić wyniki.

Wyniki testu obejmują liczbę zaliczonych i niezaliczonych testów oraz wynik końcowy, który wskazuje odsetek zaliczonych testów.

Test weryfikacji łączenia kont

Łączenie kont odgrywa ważną rolę w ekosystemie Google Home. Test weryfikacji połączenia konta w aplikacji Test Suite sprawdza usługę OAuth pod kątem potencjalnych problemów.

Test weryfikacji połączenia kont obejmuje testy umożliwiające weryfikację tokenów dostępu i tokenów odświeżania:

Test weryfikacji tokena dostępu

Tokeny dostępu zwracane z punktu końcowego wymiany tokenów są testowane pod kątem prawidłowego formatu i zwracanych prawidłowych tokenów odświeżania.

Elementy do testowania	Objaśnienie
Sprawdź, czy token dostępu jest w formacie JWT	Łączenie kont Google nie zaleca stosowania tokenów dostępu do formatu JWT. W przypadku znalezienia formatu tokena JWT wyświetla się następujące ostrzeżenie: 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.
Sprawdź, czy token dostępu, który można wykorzystać, ma token odświeżania.	Jeśli token dostępu jest nieważny, musisz podać token odświeżania. Jeśli ten token nie zostanie znaleziony, test zakończy się niepowodzeniem.

Odśwież test weryfikacji tokena

Tokeny odświeżania są testowane, by sprawdzić, czy punkt końcowy wymiany tokenów prawidłowo wymienia je na nowe tokeny dostępu.

Elementy do testowania	Objaśnienie
Odśwież token z nieprawidłowym tokenem odświeżania, sprawdzając odpowiedź partnera.	Serwer powinien zwrócić błąd HTTP 400 Bad Request z {"error": "invalid_grant"} do nieprawidłowego żądania tokena odświeżania. Jeśli odpowiedź nie pasuje do „kodu błędu lub komunikatu”, ten przypadek testowy się nie powiedzie. Więcej informacji znajdziesz w sekcji Wymienianie tokenów odświeżania w przypadku tokenów dostępu.
Sprawdź, czy token dostępu został zaktualizowany po odświeżeniu tokena.	W odpowiedzi na żądania odświeżania tokenów należy zwrócić nowe tokeny dostępu. Jeśli Twój serwer dostarcza ten sam token dostępu, przypadek testowy się nie uda.
Sprawdź, czy token dostępu jest nadal ważny.	Pojawi się data ważności tokena dostępu.
Sprawdź, czy token odświeżania został obrócony podczas odświeżania.	Sprawdzamy, czy tokeny odświeżania są zmienione po przesłaniu żądania odświeżenia. W przypadku zmiany tokena odświeżania serwer powinien unieważnić stary token dopiero po użyciu nowego tokena odświeżania, aby uniknąć warunków wyścigu, które mogą zakłócić łączenie kont użytkownika. Test zakończy się niepowodzeniem, jeśli unieważnisz stary token odświeżania przed użyciem nowego.

Komunikaty o błędach

W tabeli poniżej znajdziesz kilka typowych komunikatów o błędach i sugerowane sposoby ich rozwiązania.

Komunikat o błędzie	Jak rozwiązać problem
Interfejs HomeGraph API nie był wcześniej używany w projekcie <_id_> lub jest wyłączony	Sprawdź, czy masz włączony interfejs API HomeGraph.
Nie znaleziono żądanego elementu	Sprawdź, czy usługa agentUserId jest prawidłowa i połączona z Twoją usługą.
Sprawdź, czy masz uprawnienie resourcemanager.projects.get dotyczące projektu ${your project id} i czy masz przyznane wszystkie uprawnienia na ekranie zgody. Podczas pobierania danych modułu wystąpił błąd: getModuleData error: odpowiedź na niepowodzenie HTTP dla protokołu https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403	Wykonaj instrukcje podane w artykule Rozwiązywanie problemów z uprawnieniami, aby upewnić się, że Twoje konto ma uprawnienia resourcemanager.projects.get dotyczące projektu. Otwórz stronę Aplikacje, które mają dostęp do Twojego konta, aby sprawdzić te uprawnienia dotyczące pakietu „Inteligentny dom”: podstawowe informacje o koncie; Wyświetlanie podstawowego adresu e-mail Twojego konta Google Wyświetlanie Twoich danych osobowych, w tym udostępnionych przez Ciebie publicznie Dodatkowy dostęp Użyj konta Assistant: szeroki dostęp do konta Google Sprawdzanie inteligentnych urządzeń domowych w Twoim Home Graph i sterowanie nimi Jeśli wystąpi błąd dotyczący uprawnień, najpierw usuń dostęp, a gdy zalogujesz się ponownie, przyznaj wszystkie uprawnienia na ekranie zgody.

Prześlij wyniki testu

Przed przesłaniem formularza certyfikacji musisz uzyskać wszystkie wyniki (Test Suite). Jeśli masz cechy, które wymagają ręcznego testowania, uruchom narzędzie Test Suite i dołącz wynik, nawet jeśli nie został zaliczony w 100%.

Aby przesłać wyniki testu i potwierdzić działanie inteligentnego domu, wykonaj te czynności:

1. Gdy otrzymasz wyniki testu i będziesz gotowy do potwierdzenia, że korzystasz z inteligentnego domu, w narzędziu Test Suite kliknij Prześlij.
2. Aby pobrać wyniki testu, kliknij przycisk POBIERZ WYNIKI TESTU.
3. Kliknij PRZEJDŹ DO FORMULARZE ZGŁOSZENIA, by przesłać wyniki testu do Google.

4. Wypełnij wszystkie wymagane pola i kliknij Prześlij.