시작하기

Device Access 프로그램을 사용하면 사용자가 SDM API를 사용하여 Google Nest 기기에 액세스하고 이를 제어하며 관리할 수 있습니다.

Device Access를 시작하려면 다음 작업을 완료해야 합니다.

1. 프로그램 Device Access 등록
2. Google 계정으로 지원되는 Nest 기기 활성화하기
3. Google Cloud 프로젝트를 만들어 SDM API를 사용 설정하고 OAuth 2.0 클라이언트 ID를 가져옵니다.
4. 프로젝트 ID를 받을 Device Access 프로젝트 만들기

기기 액세스 등록

첫 번째 프로젝트를 만들기 전에 Device Access에 등록해야 합니다. 등록은 Google API 및 기기 액세스 샌드박스 서비스 약관에 동의해야 하며 계정당 일회성 환불 수수료 (미화 5달러)가 부과됩니다.

서비스 약관에 모두 동의하고 등록 수수료를 결제해야 프로젝트를 만들 수 있습니다. 이는 개별 사용자와 상업용 제품을 만들려는 모든 사용자에게 적용됩니다.

아직 등록하지 않았다면 Device Access Console에서 등록합니다.

Device Access Console로 이동

경고: 조직에서 일하는 경우 개인 또는 개별 이메일 주소가 아닌 일반 팀 이메일 주소를 사용하여 등록하세요. 계정이 생성된 후에는 Device Access Console의 이메일 주소를 변경할 수 없습니다. 계속하기 전에 올바른 이메일 주소로 로그인했는지 확인하세요.

자세한 내용은 Device Access 등록을 참고하세요.

지원되는 기기 활성화

프로그램에서 지원되는 Device Access 기기

• 모든 Google Nest 온도 조절기
• 모든 Google Nest 카메라
• 모든 Google Nest Doorbell
• Google Nest Hub Max

개별 기기 모델 목록은 지원되는 기기 페이지를 참고하세요.

참고: 지원되는 기기는 Google 계정으로 활성화해야 합니다. 기존 Nest 계정은 Device Access에서 지원되지 않습니다. 기존 Nest 계정을 이전하는 방법에 관한 자세한 내용은 Nest 앱 계정에 관한 FAQ를 참고하세요.

지원되는 기기를 활성화하는 방법은 기기 설명서를 참고하세요.

Google Cloud Platform 설정

SDM API에 대한 액세스는 Google Cloud를 통해 제공됩니다. API를 사용 설정하고 지원되는 Nest 기기에서 Google 계정을 승인하려면 Google Cloud 프로젝트가 필요합니다.

아래의 API 사용 설정 및 OAuth 2.0 클라이언트 ID 가져오기 버튼을 사용하여 Smart Device Management API를 사용 설정하고 OAuth 2.0 클라이언트 ID를 가져옵니다.

1. Device Access에 사용할 기존 Google Cloud 프로젝트가 있으면 먼저 해당 프로젝트의 관리자 계정으로 로그인했는지 확인하세요. 그런 다음 버튼을 클릭한 후 사용 가능한 프로젝트 목록에서 기존 프로젝트를 선택합니다. 그렇지 않으면 새 프로젝트를 만듭니다.
2. '어떤 국가에서 전화하시나요?'라는 메시지가 표시되면 웹 서버를 선택합니다.
3. 승인된 리디렉션 URI 값으로 https://www.google.com을 입력합니다. PCM을 사용하여 승인 코드를 가져오려면 리디렉션 URI가 필요합니다.
4. 설정이 완료되면 OAuth 2.0 클라이언트 ID와 클라이언트 보안 비밀번호 값을 복사하고 사용자 인증 정보 JSON을 로컬 머신에 다운로드합니다.

API 사용 설정 및 OAuth 2.0 클라이언트 ID 가져오기

Google Cloud 프로젝트를 수동으로 설정하거나 설정을 확인하고 사용자 인증 정보를 다시 가져오려면 다음 안내를 따르세요.

1. API 사용 설정 페이지에서 Smart Device Management API를 사용 설정합니다.
2. 사용자 인증 정보 페이지에서 OAuth 2.0 클라이언트 ID를 가져옵니다.

기기 액세스 프로젝트 만들기

Console로 Device Access 돌아갑니다.

1. Console 홈 화면에서 프로젝트 만들기를 선택합니다.
2. 생성 프로세스의 각 화면을 작성합니다.
   1. 프로젝트 이름을 입력하세요.
   2. Google Cloud 설정 중에 생성된 OAuth 2.0 클라이언트 ID를 입력합니다. 이전에 OAuth 클라이언트 ID를 복사하지 않은 경우 다운로드한 credentials.json 파일에서 찾을 수 있습니다.
      참고: SDM API와 함께 프로젝트를 사용하려면 다음 단계를 따르세요.

      • 프로젝트에 유효한 OAuth 클라이언트 ID를 지정해야 합니다.
      • OAuth 클라이언트 ID는 유효하고 project마다 고유해야 하며 다른 project과 공유될 수 없습니다.
   3. 이벤트를 사용 설정 또는 중지합니다. 이벤트는 Google Cloud Pub/Sub에서 관리되며 프로젝트에 대해 승인된 모든 기기 및 구조에 대한 비동기 업데이트를 제공합니다. 이벤트를 원하는 경우 사용 설정을 선택합니다. 확실하지 않으면 사용 중지를 선택하세요. 나중에 언제든지 사용 설정할 수 있습니다.
3. 완료되면 프로젝트에 32c4c2bc-fe0d-461b-b51c-f3885afff2f0와 같은 UUID 형식으로 프로젝트 ID가 할당됩니다. 이 ID는 모든 SDM API 호출에 필요하므로 기록해 둡니다.

이 프로젝트 ID는 OAuth 및 API 호출에 사용됩니다.Device Access 프로젝트에 한정되며 Google Cloud 프로젝트 ID와는 관련이 없습니다.