시작하기

이 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기기 액세스 샌드박스 서비스 약관에 동의하고 계정당 일회성 비용 (US$5)을 지불하는 것으로 이루어집니다.

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

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

Device Access 콘솔로 이동

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

지원되는 기기 활성화하기

Device Access 프로그램에서 지원되는 기기는 다음과 같습니다.

  • 모든 Google Nest Thermostat
  • 모든 Google Nest 카메라
  • 모든 Google Nest Doorbell
  • Google Nest Hub Max

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

지원되는 기기를 활성화하는 방법에 관한 자세한 내용은 기기 설명서를 참고하세요.

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를 가져옵니다.

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

Device Access Console로 돌아갑니다.

  1. Console 홈 화면에서 프로젝트 만들기를 선택합니다.
  2. 만들기 과정에서 각 화면을 작성합니다.
    1. 프로젝트 이름을 입력하세요.
    2. Google Cloud Platform 설정 중에 생성된 OAuth 2.0 클라이언트 ID를 입력합니다. 이전에 OAuth 클라이언트 ID를 복사하지 않은 경우 다운로드한 credentials.json 파일에서 찾을 수 있습니다.
    3. 이벤트 사용 설정 또는 사용 중지 이벤트는 Google Cloud Pub/Sub에서 관리하며 프로젝트에 승인된 모든 기기와 구조에 비동기 업데이트를 제공합니다. 이벤트를 원하는 경우 사용 설정을 선택합니다. 확실하지 않으면 사용 중지를 선택합니다. 나중에 언제든지 사용 설정할 수 있습니다.
  3. 완료되면 프로젝트에 UUID 형식의 프로젝트 ID(예: 32c4c2bc-fe0d-461b-b51c-f3885afff2f0)가 할당됩니다. 이 ID를 기록해 두세요. 모든 SDM API 호출에 필요합니다.

이 프로젝트 ID는 OAuth 및 API 호출에서 사용됩니다.Device Access 프로젝트에만 해당하며 Google Cloud 프로젝트 ID와는 관련이 없습니다.