Google Home Test Suite は、以下を行えるウェブ アプリケーションです。 セルフテストできます。Test Suite デバイスとトレイトに基づいてテストケースを自動的に生成して実行 関連付けられていますテストを完了すると、テスト内容の 送信フォームに記入して Google にテスト結果を送信してください。
Test Suite によって実行されるテストには次のものが含まれますが、含まれません。 次のものに限定されます。
デバイスとトレイトに Report State と Request Sync が実装されていることを確認します。
デバイスに QUERY インテントが実装されていること、その結果が Report State の結果と一致することを検証します。
ボタンをクリックすると、Test Suite ツールを起動できます 下にあります。
アクションのセルフテスト
次のセクションでは、Test Suite を実行する方法について説明します。 スマートホーム アクション プロジェクトをホストしています。Test Suite ログインする必要があります。ログインすると、お使いの Google Home Graph を使用して、コマンドを Google Assistant。
アクションをセルフテストする手順は次のとおりです。
- ウェブブラウザで Test Suite。
右上のボタンから Google にログインします。
[Project Details]（プロジェクトの詳細）を設定します。
- [プロジェクト ID] フィールドに、プロジェクトのプロジェクト ID を入力します。 スマートホーム アクション。
- [次へ] をクリックします。
[Test Settings]（テスト設定）を構成します。
- スマートホーム アクションを認定する場合は、デフォルトの Report State / Request Sync Timeout 値をそのまま使用します。ただし、エージェントがホームグラフに状態を報告するのに時間がかかる場合は、テスト目的でタイムアウト値を変更できます。
スマートホーム アクションを認定する場合は、[Test Request Sync]（Request Sync のテスト）オプションが有効になっていることを確認します。テスト中は、デバイスを追加、更新、削除して、ホームグラフでデバイスリストが変更されたかどうかを確認するよう求めるメッセージが表示されます。変更アクションは統合によって行われます 説明します。テスト対象の統合には、必ず 1 つ以上のデバイスが必要です エージェントユーザーに割り当てる 必要があります
Scene トレイトを使用している場合は、次を選択します。 テストシーン トレイト。
ローカルホーム デバイスのテストスイートを実行している場合は、 Local Home SDK をサポートしています。
- [Local Fulfillment] または [シームレス連携のセットアップ] を選択します。
- デバイスが QUERY インテントを処理できる場合は、[Supports Local Query] をクリックします。 説明します。
[Test Run]（テスト実行）を実行して結果を表示します。
- [Next] をクリックして、テストの実行を開始します。インターフェースにテスト対象のデバイスとトレイトが表示されます。
[Results & Submission]（結果と送信）ページを表示します。
- テストが完了したら、[Next] をクリックして結果を表示します。
テスト結果には、成功したテストと失敗したテストの件数、および成功率（%）を示す最終スコアが表示されます。
アカウントのリンク検証テスト
アカウントのリンクでは、 Google のスマートホーム エコシステムで重要な役割を果たしています。アカウントのリンク Test Suite の検証テストでは、OAuth サービスが 役立ちます。
アカウントのリンク検証テストには、アクセス トークンを検証するテストが含まれています。 更新トークン:
アクセス トークンの検証テスト
トークン交換エンドポイントから返されたアクセス トークンをテストして、 有効な形式であり、有効な更新トークンとともに返される。
| テスト項目 | 説明 |
|---|---|
| アクセス トークンが JWT 形式かどうかを確認する | Google アカウントのリンクでは、JWT 形式のアクセス トークンは推奨されません。もし
JWT 形式が見つかると、次の警告が表示されます。
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.
|
| 有効期限付きのアクセス トークンに更新トークンが含まれていることを確認します。 | アクセス トークンが期限切れの場合は、更新トークンを指定する必要があります。 更新トークンが見つからない場合、このテストは失敗します。 |
更新トークンの検証テスト
更新トークンをテストして、トークン交換エンドポイントが適切に行われていることを確認します 新しいアクセス トークンと交換します。
| テスト項目 | 説明 |
|---|---|
| 更新トークンに無効な更新トークンが含まれています。パートナーの応答を確認してください。 | サーバーから HTTP 400 Bad Request エラーが返されるはずです。
{"error": "invalid_grant"} は無効な更新トークン リクエストにマッピングされます。
レスポンスが「error code or message」と一致しない場合は、このテストケースで
失敗します<ph type="x-smartling-placeholder"></ph>にアクセス
更新トークンをアクセス トークンに交換するをご覧ください。 |
| トークンの更新後にアクセス トークンが更新されたかどうかをテストします。 | 更新トークンに応じて新しいアクセス トークンを返す必要がある できます。サーバーから同じアクセス トークンが提供されている場合、テストケースは 失敗します。 |
| 有効期限内のアクセス トークンがまだ有効かどうかを確認します。 | アクセス トークンの有効期限が表示されます。 |
| 更新中に更新トークンがローテーションされたかどうかを確認します。 | 更新トークンのリクエスト後に更新トークンが変更されているかどうかを確認します。条件 更新トークンが変更された場合、サーバーでは古い更新のみ 新しい更新トークンを使用した後のトークンの再利用と、競合状態を防止 ユーザーのアカウントのリンクが解除される可能性があります。次の場合、テストは不合格になります。 新しいトークンを使用する前に古い更新トークンを無効にする |
エラー メッセージ
次の表は、一般的なエラー メッセージと、推奨される解決方法を示します。
| エラー メッセージ | 解決方法 |
|---|---|
| HomeGraph API has not been used in project <_id_> before or it is disabled（HomeGraph API がこれまでプロジェクト <_id_> で使用されたことがないか、または無効になっています） | HomeGraph API が有効になっていることを確認します。 |
| Requested Entity not found（要求されたエンティティが見つかりません） | agentUserId が有効で、リンクされていることをご確認ください
あります。 |
モジュール データの取得中にエラーが発生しました: getModuleData error: HTTP 失敗レスポンス https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
テスト結果の送信
Test Suite の結果は、次の日付までにテストの 100% に合格する必要があります。 認定フォームを送信してください。なんらかの理由で 手動テストでも Test Suite ツールを実行し、 100% に達していなくても結果が添付されます。
テスト結果を送信し、スマートホーム アクションを認定する手順は次のとおりです。
- テスト結果を受け取ったら、 home アクションで、Test Suite ツールで [Submit] をクリックします。
- [DOWNLOAD TEST RESULTS]（テスト結果のダウンロード）ボタンをクリックして、テスト結果を取得します。
- テスト結果を Google に送信するには、[GO TO SUBMISSION FORM]（送信フォームに移動）をクリックします。
すべての必須フィールドに入力してから、[Submit] をクリックします。