Google Home 테스트 도구 모음

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Cloud-to-cloud 로컬 홈 SDK

Google Home Test Suite는 스마트 홈 작업을 자체 테스트할 수 있는 웹 애플리케이션입니다. Test Suite는 계정과 연결된 기기 및 특성에 따라 자동으로 테스트 사례를 생성하고 실행합니다. 테스트를 완료하면 테스트 결과를 보거나 제출 양식을 작성하여 테스트 결과를 Google에 제출할 수 있습니다.

Test Suite에서 실행하는 테스트에는 다음이 포함되나 이에 국한되지 않습니다.

  • 기기 및 특성에 보고서 상태요청 동기화가 구현되었는지 확인합니다.

  • 기기에 QUERY 인텐트가 구현되었고 결과가 보고서 상태 결과와 일치하는지 확인합니다.

아래 버튼을 클릭하여 Test Suite 도구를 실행할 수 있습니다.

Test Suite 실행

작업 자체 테스트

다음 섹션에서는 기기 및 스마트 홈 작업 프로젝트에서 Test Suite를 실행하는 방법을 설명합니다. Test Suite에서 Google Home Graph의 기기를 검사하고 Google Assistant에 직접 명령어를 전송할 수 있도록 로그인해야 합니다.

작업을 자체 테스트하려면 다음 단계를 따르세요.

  1. 웹브라우저에서 Test Suite을 엽니다.
  2. 오른쪽 상단에 있는 Google 버튼을 사용하여 로그인합니다.

  3. 프로젝트 세부정보를 구성합니다.

    1. 프로젝트 ID 필드에 스마트 홈 작업의 프로젝트 식별자를 입력합니다.
    2. 다음을 클릭합니다.
  4. 테스트 설정을 구성합니다.

    1. 스마트 홈 작업을 인증하는 경우 Report State/Request Sync Timeout 값을 변경하지 않고 그대로 둡니다. 그러나 테스트의 경우 에이전트가 홈 그래프에 상태를 보고하는 데 시간이 더 오래 걸리는 경우 제한 시간 값을 변경할 수 있습니다.
    2. 스마트 홈 작업을 인증하는 경우 테스트 요청 동기화 옵션이 사용 설정되어 있는지 확인합니다. 테스트 중에 기기를 추가, 업데이트 또는 삭제하고 홈 그래프에서 기기 목록이 변경되었는지 확인하라는 메시지가 표시됩니다. 변경 작업은 테스트 중인 통합을 통해 실행됩니다. 테스트 중인 통합에는 항상 에이전트 사용자에게 하나 이상의 기기가 연결되어 있어야 합니다.

    3. 장면 특성을 사용하는 경우장면 특성 테스트를 선택합니다.

  5. 테스트 실행을 실행하고 결과를 확인합니다.

    1. 다음을 클릭하여 테스트 실행을 시작합니다. 인터페이스에 테스트 중인 기기와 특성이 표시됩니다.
  6. 결과 및 제출 페이지를 봅니다.

    1. 테스트가 완료되면 다음을 클릭하여 결과를 확인합니다.

테스트 결과에는 통과 및 실패한 테스트 수와 통과 비율을 보여주는 최종 점수가 포함됩니다.

계정 연결 확인 테스트

계정 연결은 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. 경고가 표시됩니다.
만료되는 액세스 토큰에 갱신 토큰이 있는지 확인하세요. 액세스 토큰이 만료될 때 갱신 토큰을 제공해야 합니다. 갱신 토큰이 없으면 테스트가 실패합니다.

갱신 토큰 유효성 검사 테스트

갱신 토큰을 테스트하여 토큰 교환 엔드포인트가 새 액세스 토큰으로 올바르게 교환하는지 확인합니다.

테스트 항목 설명
갱신 토큰이 잘못된 갱신 토큰으로 파트너 응답을 확인합니다. 서버에서 {"error": "invalid_grant"}가 포함된 HTTP 400 잘못된 요청 오류를 잘못된 갱신 토큰 요청에 반환해야 합니다. 응답이 '오류 코드 또는 메시지'와 일치하지 않으면 이 테스트 사례는 실패합니다. 자세한 내용은 액세스 토큰을 갱신 토큰으로 교환하세요.
토큰 새로고침 후 액세스 토큰이 업데이트되었는지 테스트합니다. 갱신 토큰 요청에 대한 응답으로 새 액세스 토큰을 반환해야 합니다. 서버가 동일한 액세스 토큰을 제공하는 경우 테스트 사례가 실패합니다.
만료되지 않은 액세스 토큰이 아직 유효한지 확인합니다. 액세스 토큰 만료 시간이 표시됩니다.
갱신 중에 갱신 토큰이 순환되었는지 확인합니다. 갱신 토큰이 요청된 후 갱신 토큰이 변경되었는지 확인합니다. 갱신 토큰이 변경되면 새로운 갱신 토큰이 사용된 후에만 서버에서 이전 갱신 토큰을 무효화해야 합니다. 이는 사용자의 계정 연결이 손상될 수 있는 경합 상태를 방지하기 위함입니다. 새 갱신 토큰이 사용되기 전에 이전 갱신 토큰을 무효화하면 테스트가 실패합니다.

오류 메시지

다음 표에는 발생할 수 있는 일반적인 오류 메시지와 권장되는 해결 방법이 나와 있습니다.

오류 메시지 해결 방법
전에 <____g HomeGraph API를 사용 설정했는지 확인합니다.
요청된 항목을 찾을 수 없습니다. agentUserId가 유효하고 서비스에 연결되어 있는지 확인하세요.
${your project id} 프로젝트에 대한 resourcemanager.projects.get 권한이 있고 동의 화면에서 모든 권한을 부여했는지 확인하세요.
  1. IAM 권한 문제 해결의 안내에 따라 계정에 프로젝트의 resourcemanager.projects.get 권한이 있는지 확인합니다.
  2. 내 계정에 액세스할 수 있는 앱 페이지로 이동하여 '스마트 홈용 테스트 모음'에 대한 다음 권한을 확인하세요.
    • 기본 계정 정보
      1. 기본 Google 계정 이메일 주소를 확인하세요
      2. 개인정보(공개로 설정한 개인정보 포함) 보기
    • 추가 액세스
      1. Assistant 사용: Google 계정에 대한 광범위한 액세스
      2. Home Graph의 스마트 홈 기기 검사 및 제어
    누락된 사람이 있으면 먼저 액세스 권한을 삭제하고 다시 로그인할 때 동의 화면의 모든 권한을 부여합니다.

테스트 결과 제출

인증 양식을 제출하기 전에 Test Suite 결과가 테스트의 100% 를 통과해야 합니다. 수동 테스트가 필요한 특성이 있다면 Test Suite 도구를 실행하고 결과가 100%를 통과하지 못했더라도 결과를 연결해야 합니다.

테스트 결과를 제출하고 스마트 홈 작업을 인증하려면 다음 단계를 따르세요.

  1. 테스트 결과를 받고 스마트 홈 작업을 인증할 준비가 되면 Test Suite 도구에서 Submit을 클릭합니다.
  2. 테스트 결과 다운로드 버튼을 클릭하여 테스트 결과를 가져옵니다.
  3. 제출 양식으로 이동을 클릭하여 테스트 결과를 Google에 제출하세요.
  4. 필수 입력란을 모두 작성한 다음 제출을 클릭합니다.