Home API는 OAuth 2.0을 사용하여 구조의 기기에 대한 액세스 권한을 부여합니다. OAuth를 사용하면 사용자가 로그인 사용자 인증 정보를 노출하지 않고도 앱 또는 서비스에 권한을 부여할 수 있습니다.
이미 확인된 OAuth 클라이언트 (예: 이미 게시된 앱의 클라이언트)가 있는 경우 이 클라이언트를 사용하여 새 클라이언트를 설정하지 않고도 Home API를 테스트할 수 있습니다. 자세한 내용은 기존 OAuth 클라이언트가 있는 경우를 참고하세요.
앱 서명
먼저 Android Studio에서 앱을 실행하여 OAuth 키를 생성합니다. Android Studio에서 앱을 실행하거나 디버그하면 개발 및 디버깅을 위한 OAuth 키가 자동으로 생성됩니다. 자세한 설명은 Android 스튜디오: 디버그 빌드 서명을 참고하세요.
앱이 실행되면 다음 단계를 따르세요.
휴대기기를 로컬 머신에 연결합니다. Android Studio에는 연결된 기기가 모델 번호별로 표시됩니다. 목록에서 기기를 선택한 다음 프로젝트 실행을 클릭합니다. 이렇게 하면 샘플 앱이 빌드되고 휴대기기에 설치됩니다.
자세한 안내는 Android 개발자 사이트의 하드웨어 기기에서 앱 실행을 참고하세요.
실행 중인 앱을 중지합니다.
Google Cloud 콘솔 도움말 사이트의 OAuth 2.0 / 네이티브 애플리케이션/Android 설정에 자세히 설명된 안내에 따라 OAuth 인증서의 SHA-1 지문을 가져옵니다.
OAuth 동의 화면 설정
- Google Cloud 콘솔에서 프로젝트 선택기 대시보드로 이동하여 OAuth 사용자 인증 정보를 만드는 데 사용할 프로젝트를 선택합니다.
- API 및 서비스 페이지로 이동하여 탐색 메뉴에서 사용자 인증 정보를 클릭합니다.
이 Google Cloud 프로젝트에 동의 화면을 아직 구성하지 않은 경우 동의 화면 구성 버튼이 표시됩니다. 이 경우 다음 절차에 따라 동의 화면을 구성합니다. 그렇지 않으면 다음 섹션으로 이동합니다.
- 동의 화면 구성을 클릭합니다. OAuth 동의 화면 페이지가 표시됩니다.
- 사용 사례에 따라 내부 또는 외부를 선택한 다음 만들기를 클릭합니다. OAuth 동의 화면 창이 표시됩니다.
- 화면에 표시된 안내에 따라 앱 정보 페이지에 정보를 입력한 다음 저장하고 계속하기를 클릭합니다. 범위 창이 표시됩니다.
- 범위를 추가할 필요가 없으므로 저장하고 계속하기를 클릭합니다. 테스트 사용자 창이 표시됩니다.
- 앱 액세스 권한을 테스트할 사용자를 추가하려면 사용자 추가를 클릭합니다. 사용자 추가 창이 표시됩니다. 테스트 사용자에게는 앱에서 권한을 부여할 권한이 있습니다.
- 빈 필드에 하나 이상의 Google 계정 이메일 주소를 추가한 다음 추가를 클릭합니다.
- 저장하고 계속하기를 클릭합니다. 요약 창이 표시됩니다.
- OAuth 동의 화면 정보를 검토한 다음 대시보드로 돌아가기를 클릭합니다.
자세한 내용은 Google Cloud 콘솔 도움말 사이트의 OAuth 동의 화면 설정을 참고하세요.
앱 등록 및 사용자 인증 정보 만들기
OAuth 2.0용 앱을 등록하고 OAuth 사용자 인증 정보를 만들려면 OAuth 2.0 설정에 제공된 안내를 따르세요. 앱 유형(네이티브/Android 앱)을 표시해야 합니다.
Google Cloud 콘솔 도움말 사이트의 OAuth 2.0 / 네이티브 애플리케이션 설정에 나온 안내에 따라 앱 서명에서 가져온 SHA-1 지문을 Google Cloud 콘솔에서 설정한 OAuth 클라이언트에 추가합니다.
휴대기기를 로컬 머신에 연결한 상태에서 목록에서 기기를 선택한 다음 프로젝트 실행을 다시 클릭하여 프로젝트를 실행합니다. 자세한 안내는 Android 개발자 사이트의 하드웨어 기기에서 앱 실행을 참고하세요.
기존 OAuth 클라이언트가 있는 경우
게시된 앱에 대해 이미 확인된 OAuth 클라이언트가 있는 경우 기존 OAuth 클라이언트를 사용하여 Home API를 테스트할 수 있습니다.
Home API를 테스트하고 사용하기 위해 Google Home Developer Console 등록은 필요하지 않습니다. 하지만 다른 통합에서 확인된 OAuth 클라이언트가 있더라도 앱을 게시하려면 승인된 Developer Console 등록이 필요합니다.
다음 고려사항이 적용됩니다.
기존 OAuth 클라이언트를 사용하는 경우 사용자 한도가 100명입니다. 테스트 사용자를 추가하는 방법에 관한 자세한 내용은 OAuth 동의 화면 설정을 참고하세요. OAuth 인증과는 별도로 애플리케이션에 권한을 부여할 수 있는 사용자는 Home API에서 100명으로 제한합니다. 이 제한은 Developer Console 등록이 완료되면 해제됩니다.
Home API로 앱을 업데이트하기 위해 OAuth를 통해 기기 유형 부여를 제한할 준비가 되면Developer Console 등록 을 승인받기 위해 전송해야 합니다.
아직 OAuth 인증이 대기 중인 Google Cloud 앱의 경우 인증이 완료될 때까지 사용자는 OAuth 흐름을 완료할 수 없습니다. 권한을 부여하려고 하면 다음 오류와 함께 실패합니다.
Access blocked: <Project Name> has not completed the Google verification process.