Google Home Test Suite,

Google Home Test Suite to aplikacja internetowa, która pozwala samodzielnie przetestować akcję inteligentnego domu. Test Suite automatycznie generuje i uruchamia przypadki 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 zgłoszeniowy, aby przesłać wyniki testu do Google.

Testy wykonywane przez Test Suite obejmują między innymi:

• Sprawdza, czy stan raportu i synchronizacja żądania są zaimplementowane dla Twoich urządzeń i cech.

• Sprawdza, czy na urządzeniu została wdrożona intencja QUERY, a jej wyniki są zgodne z wynikami stanu raportu.

Możesz uruchomić narzędzie Test Suite, klikając przycisk poniżej:

Uruchom Test Suite

Samodzielnie przetestuj akcję

Z tej sekcji dowiesz się, jak uruchomić Test Suite na urządzeniu i w projekcie akcji w inteligentnym domu. Test Suite wymaga zalogowania się w celu sprawdzania urządzeń w Google Home Graph i wysyłania poleceń bezpośrednio do Google Assistant.

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

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

2. Zaloguj się na konto Google, klikając przycisk w prawym górnym rogu.

3. Skonfiguruj Szczegóły projektu:

   1. W polu Project ID (Identyfikator projektu) wpisz identyfikator projektu inteligentnego domu.
   2. Kliknij Dalej.

4. Skonfiguruj ustawienia testu:

   1. W przypadku certyfikacji akcji w inteligentnym domu pozostaw wartość domyślną Stan raportu/Czas oczekiwania na synchronizację żądania nie zmieniaj. W przypadku testów możesz jednak zmienić wartość limitu czasu, jeśli agent potrzebuje więcej czasu na zgłoszenie stanu do Home Graph.

   2. Jeśli przeprowadzasz certyfikację działania inteligentnego domu, upewnij się, że jest włączona opcja Test Request Sync (Testuj synchronizację żądań). Podczas testów wyświetli się prośba o dodanie, zaktualizowanie lub usunięcie urządzenia oraz sprawdzenie, czy zmieniła się lista urządzeń w Home Graph. Działania związane ze zmianą są wprowadzane w ramach testowanej integracji. Z użytkownikiem agenta musi być zawsze połączone co najmniej 1 urządzenie w trakcie testu.

   3. Jeśli korzystasz z cechy Scene, wybierz Przetestuj cechę sceny.

   4. Jeśli korzystasz z pakietu testowego dla lokalnych urządzeń Home, wybierz Obsługuje pakiet Local Home SDK.

      1. Wybierz Realizacja lokalna lub Łatwa konfiguracja.
      2. Kliknij Obsługuje zapytanie lokalne, jeśli urządzenie może lokalnie obsłużyć intencję QUERY.

5. Przeprowadź test testowy i wyświetl wyniki:

   1. Kliknij Dalej, aby rozpocząć testy. Interfejs pokazuje testowane urządzenia i cechy.

6. Wyświetl stronę Wyniki i przesł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 inteligentnego domu Google. Test poprawności łączenia kont w Test Suite sprawdza, czy usługa OAuth nie zawiera potencjalnych problemów.

Test weryfikacji łączenia kont obejmuje testy do weryfikacji 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 zwracane z prawidłowym tokenem odświeżania.

Elementy testowe	Wyjaśnienie
Sprawdź, czy token dostępu jest w formacie JWT	Łączenie kont Google nie zaleca tokenów dostępu w formacie JWT. Jeśli zostanie znaleziony format JWT, wyświetli się to 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ź wygasający token dostępu ma token odświeżania.	Jeśli token dostępu wygaśnie, należy podać token odświeżania. Jeśli nie zostanie znaleziony token odświeżania, ten test zakończy się niepowodzeniem.

Odśwież test weryfikacji tokena

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

Elementy testowe	Wyjaśnienie
Odśwież token z nieprawidłowym tokenem odświeżania – sprawdzam odpowiedź partnera.	W odpowiedzi na nieprawidłowe żądanie tokena odświeżania Twój serwer powinien zwracać błąd HTTP 400 Bad Request (Nieprawidłowe żądanie) HTTP 400 ({"error": "invalid_grant"}). Jeśli odpowiedź nie będzie zgodna z „kodem błędu lub komunikatem”, ten przypadek testowy zakończy się niepowodzeniem. Więcej informacji znajdziesz w artykule o wymianie tokenów odświeżania tokenów dostępu.
Sprawdź, czy token dostępu został zaktualizowany po odświeżeniu tokena.	W odpowiedzi na żądania tokenów powinny być zwracane nowe tokeny dostępu. Jeśli Twój serwer udostępnia ten sam token dostępu, przypadek testowy zakończy się niepowodzeniem.
Sprawdź, czy ważny token dostępu jest nadal ważny.	Wyświetli się data ważności tokena dostępu.
Sprawdź, czy token odświeżania nie został poddany rotacji podczas odświeżania.	Sprawdzamy, czy tokeny odświeżania zostały zmienione po otrzymaniu żądania tokena odświeżania. Jeśli token odświeżania ulegnie zmianie, Twój serwer powinien unieważnić stary token odświeżania tylko po użyciu nowego, aby uniknąć warunków wyścigu, które mogą zerwać połączenie kont użytkownika. Test nie powiedzie się, jeśli unieważnisz stary token odświeżania przed użyciem nowego.

Komunikaty o błędach

W tabeli poniżej znajdziesz niektóre typowe komunikaty o błędach, które możesz napotkać, oraz sposoby ich rozwiązywania.

Komunikat o błędzie	Rozwiązanie
Interfejs HomeGraph API nie był używany w projekcie <_id_> wcześniej lub jest wyłączony	Sprawdź, czy masz włączony HomeGraph API.
Nie znaleziono żądanego elementu	Sprawdź, czy agentUserId jest prawidłowy i połączony z Twoją usługą.
Sprawdź, czy masz uprawnienia resourcemanager.projects.get w projekcie ${your project id} i przyznaj wszystkie uprawnienia na ekranie zgody. Podczas pobierania danych modułu wystąpił błąd: getModuleData: odpowiedź błędu protokołu HTTP dla https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403	Wykonaj instrukcje opisane w artykule Rozwiązywanie problemów z uprawnieniami, aby upewnić się, że Twoje konto ma uprawnienia resourcemanager.projects.get do projektu. Otwórz stronę Aplikacje, które mają dostęp do Twojego konta, aby sprawdzić te uprawnienia w sekcji „Pakiet testowy dla inteligentnego domu”: 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 Assistant: szeroki dostęp do konta Google Sprawdzanie inteligentnych urządzeń domowych w Home Graph i sterowanie nimi Jeśli wyświetli się błąd dotyczący uprawnień, najpierw odbierz dostęp i przyznaj wszystkie uprawnienia na ekranie zgody, gdy ponownie się zalogujesz.

Przesyłanie wyników testu

Zanim prześlesz formularz certyfikacyjny, Twoje wyniki testu Test Suite muszą przejść wszystkie testy. Jeśli masz cechy, które wymagają przetestowania ręcznego, uruchom narzędzie Test Suite i dołącz wynik, nawet jeśli nie został zaliczony.

Aby przesłać wyniki testu i certyfikować swoje działanie w inteligentnym domu, wykonaj te czynności:

1. Gdy otrzymasz wyniki testu i chcesz przejść do certyfikacji inteligentnego akcji w domu, w narzędziu Test Suite kliknij Prześlij.
2. Aby pobrać wyniki testu, kliknij przycisk POBIERZ WYNIKI TESTU.
3. Aby przesłać wyniki testu do Google, kliknij PRZEJDŹ DO FORMULARZA ZGŁOSZEŃ.

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