Nest 연동은 Home Assistant에서 절차가 가장 번거로운 통합 중 하나이며, VPN 환경이 필요합니다. Google이 요구하는 보안 인증이 매우 엄격하기 때문입니다.
마음의 준비를 하세요. 전체 과정은 약 20-30분이 걸리며, Google이 5달러의 일회성 개발자 비용을 청구합니다(이는 Google이 받는 것이며 HA가 아닙니다).
✅ 준비 작업 (필독)
- 계정: Google 계정이 필요합니다(G-Suite가 아닌 개인 Gmail 권장).
- 외부 접속: Home Assistant가 HTTPS로 접속 가능해야 합니다(예: SSL 인증서 설정). 또는 Nabu Casa 클라우드 서비스를 사용 중이어야 합니다.
- 신용카드: Google Device Access의 5달러 결제에 사용합니다.
- PC 작업: 반드시 PC 브라우저에서 작업하고 휴대폰은 사용하지 마세요.
1단계: Google Cloud 프로젝트 (GCP) 만들기
먼저 API 권한을 얻기 위해 Google에 클라우드 프로젝트를 신청해야 합니다.
- 접속하여 로그인합니다.
- 왼쪽 위의 프로젝트 드롭다운 메뉴를 클릭하고 새 프로젝트 (New Project)를 선택합니다.
- 프로젝트 이름: 아무거나 입력하세요. 예: HA-Nest.
- 만들기 (Create)를 클릭합니다.
프로젝트가 생성되면 왼쪽 위에서 방금 만든 HA-Nest 프로젝트가 선택되어 있는지 확인합니다.
API 활성화:
- 왼쪽 메뉴에서 API 및 서비스 > 라이브러리 (Library)를 클릭합니다.
- Smart Device Management API를 검색해 클릭해 들어가 사용 설정 (Enable)합니다.
- 다시 Cloud Pub/Sub API를 검색해 클릭해 들어가 사용 설정 (Enable)합니다.
2단계: OAuth 인증 화면 구성하기
- Google Cloud Console 왼쪽 메뉴에서 API 및 서비스 > OAuth 동의 화면 (OAuth consent screen)을 클릭합니다.
- User Type에서 외부 (External)를 선택하고 만들기를 클릭합니다.
- 앱 정보:
- 앱 이름: Home Assistant
- 사용자 지원 이메일: 본인 이메일을 선택합니다.
- 개발자 연락처 이메일: 본인 이메일을 입력합니다.
- 나머지는 비워 두고 저장 후 계속을 클릭합니다.
범위 (Scopes): 그대로 저장 후 계속을 클릭해 건너뜁니다.
테스트 사용자 (Test users):
- 사용자 추가 (Add Users)를 클릭합니다.
- 반드시 본인의 Google 이메일 주소(Nest 로그인에 사용하는 것)를 입력합니다.
- 저장 후 계속을 클릭합니다.
3단계: 사용자 인증 정보 (Credentials) 받기
- 왼쪽 메뉴에서 API 및 서비스 > 사용자 인증 정보 (Credentials)를 클릭합니다.
- 상단의 사용자 인증 정보 만들기 (Create Credentials) > OAuth 클라이언트 ID (OAuth client ID)를 클릭합니다.
- 애플리케이션 유형: 웹 애플리케이션 (Web application)을 선택합니다.
- 이름: HA Credentials.
- 승인된 리디렉션 URI (Authorized redirect URIs):
- URI 추가를 클릭합니다.
- 입력: https://my.home-assistant.io/redirect/oauth
- 참고: 공식 권장 방식 중 가장 간단한 방법으로, 복잡한 URL을 직접 설정할 필요가 없습니다.
만들기를 클릭합니다.
중요: 화면에 클라이언트 ID (Client ID)와 클라이언트 보안 비밀 (Client Secret)이 표시됩니다.
- ⚠️ 이 두 문자열을 반드시 복사해 메모장에 저장하세요. 곧바로 사용합니다!
4단계: Device Access Console 등록 ($5 결제 필요)
- 접속합니다.
- Go to the Device Access Console을 클릭합니다.
- 약관에 동의하고 5달러 비용을 결제합니다(이전에 결제했다면 필요 없습니다).
- 결제가 완료되면 Create project를 클릭합니다.
- Project Name: HA Nest를 입력합니다.
- OAuth client ID: 3단계에서 받은 클라이언트 ID (Client ID)를 입력합니다.
- Next를 클릭합니다.
- Events: Enable Events가 체크되어 있는지 확인하고 Create project를 클릭합니다.
- 중요: 생성에 성공하면 Project ID가 표시됩니다(보통 UUID 같은 긴 문자열입니다).
- ⚠️ 이 Project ID를 복사해 메모장에 저장하고 Device Access Project ID라고 표시해 두세요.
5단계: Home Assistant에 연동하기
Home Assistant 화면으로 돌아갑니다(2025.12.2 버전).
- 왼쪽 사이드바에서 설정 (Settings) > 기기 및 서비스 (Devices & services)를 클릭합니다.
- 오른쪽 아래의 통합 추가 (Add Integration)를 클릭합니다.
- Google Nest를 검색해 클릭합니다.
- Cloud (OAuth) 방식을 선택합니다(보통 기본값).
- 다음으로 아래 핵심 정보를 입력하라는 안내가 나옵니다(메모장에서 복사하세요):
- Cloud Project ID: 1단계에서 만든 Google Cloud 프로젝트의 ID입니다(Device Access ID가 아님).
- 확인 방법: Google Cloud Console 홈 Dashboard의 프로젝트 정보 카드에서 볼 수 있습니다
Device Access Project ID: 4단계 마지막에 복사한 문자열입니다.
Client ID: 3단계에서 받은 값.
Client Secret: 3단계에서 받은 값.
다음 또는 제출을 클릭합니다.
Home Assistant가 새 창을 열고 Google 로그인과 인증을 안내합니다.
- Google에서 이 앱을 확인하지 않았다는 경고가 나오면 고급 (Advanced) > …으로 이동을 클릭합니다.
- 모든 권한을 체크합니다(Nest Thermostat, Energy 등).
- 마지막으로 연동을 확인합니다.
모든 것이 순조롭다면 페이지가 Home Assistant로 돌아오고 성공이 표시됩니다.
자주 발생하는 문제 해결
- 오류: Error 400: redirect_uri_mismatch
- 원인: 3단계에서 입력한 리디렉션 URI가 Home Assistant가 실제 사용하는 것과 일치하지 않습니다.
- 해결: Google Cloud Console의 리디렉션 URI가 https://my.home-assistant.io/redirect/oauth인지 확인하세요.
엔티티를 찾을 수 없나요?
- 통합 추가에 성공해도 동기화에 몇 초 걸릴 수 있습니다. 개발자 도구 > 상태에서 climate.로 시작하는 엔티티를 검색하세요.
Pub/Sub 오류
- 보통 HA는 Pub/Sub 구독을 자동으로 처리합니다. 오류가 나면 1단계에서 Cloud Pub/Sub API를 활성화했는지 확인하세요.
축하합니다! 이제 Home Assistant 패널에서 Nest 온도 조절기를 확인하고 제어할 수 있을 것입니다.
