이벤트 구독

이벤트는 비동기식이며 Google Cloud Pub/Sub에서 Project당 하나의 주제로 관리합니다. 이벤트는 모든 기기와 구조에 업데이트를 제공하며 액세스 토큰이 사용자에 의해 취소되지 않고 이벤트 메시지가 만료되지 않는 한 이벤트 수신은 보장됩니다.

이벤트는 SDM API의 선택적 기능입니다. Google Cloud 프로젝트를 사용하여 쉽게 구현하고 확인할 수 있습니다.

이벤트 사용 설정

이벤트는 Device Access Console에서 사용 설정할 수 있습니다. 아직 선택하지 않았다면 콘솔에서 프로젝트를 선택합니다.

Device Access 콘솔로 이동

이미 이벤트를 사용 설정한 경우 (예: 프로젝트 생성 중) 이벤트에 Pubsub 주제 사용 설정 섹션의 Pub/Sub 주제 입력란에 이미 주제 ID라는 값이 이전 형식으로 지정되어 있어야 합니다.

projects/sdm-prod/topics/enterprise-project-id

이 주제 형식은 Google에서 호스팅하며 Google에서 호스팅하는 Pub/Sub 주제를 사용 중지하지 않는 한 프로젝트에 유지됩니다. 나중에 다시 사용 설정하면 자체 호스팅 Pub/Sub 주제로 전환됩니다.

자체 호스팅 Pub/Sub 주제는 개발자 자신의 Google Cloud 프로젝트에서 만들거나 변경할 수 있습니다. 개발자는 Pub/Sub 사용과 관련된 모든 비용도 부담합니다. 자세한 내용은 Pub/Sub 가격 책정을 참고하세요.

Pub/Sub 주제를 만듭니다.

gcloud pubsub topics create {topic} --message-retention-duration=0s

프로젝트의 주제 ID에 대한 이벤트 데이터에 액세스하고 게시하는 데 필요한 SDM API 권한을 부여합니다.

gcloud pubsub topics add-iam-policy-binding projects/{project}/topics/{topic} \
--member="group:sdm-publisher@googlegroups.com" \
--role="roles/pubsub.publisher"

새로 생성된 주제 ID의 형식은 다음과 같습니다.

projects/gcp-project-name/subscriptions/topic-id

주제 ID를 기록해 둡니다. 이벤트 사용 설정을 완료하는 데 필요합니다. 자세한 내용은 주제 만들기를 참고하세요.

이벤트를 사용 설정하려면 다음 단계를 따르세요.

  1. 이벤트 사용 설정을 선택하고 프로젝트 만들기를 클릭합니다.
  2. Pub/Sub 주제의 아이콘을 클릭하고 PubSub 주제가 있는 이벤트 사용 설정을 선택합니다.
  3. 이전에 제공했거나 만든 Pub/Sub 주제 ID를 입력합니다.

주제 ID를 복사합니다. 이벤트 메시지를 검색할 수 있도록 주제의 구독을 만들 때 필요합니다.

풀 구독 만들기

가져오기 구독은 구독자가 대기열에 추가된 이벤트 메시지에 대해 Pub/Sub 서버에 요청을 시작하는 것입니다. 이 방법을 사용하면 승인된 기기에서 이벤트가 생성되고 있는지 빠르고 쉽게 확인할 수 있습니다.

Google Cloud 프로젝트의 Cloud Shell을 엽니다.

Google Cloud Shell로 이동

Cloud Shell 프롬프트에서 다음 명령어를 실행하여 원하는 subscription-id 및 고유한 주제 ID를 사용하여 주제에 대한 풀 구독을 만듭니다.

gcloud pubsub subscriptions create subscription-id --topic=projects/gcp-project-name/subscriptions/topic-id
Created subscription [projects/gcp-project-name/subscriptions/subscription-id].

이벤트 시작

Pub/Sub 구독이 생성된 후 이벤트를 처음 시작하려면 기기를 일회성 트리거로 나열하도록 호출합니다.

curl -X GET 'https://smartdevicemanagement.googleapis.com/v1/enterprises/project-id/devices' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer access-token'

이 API 호출 후에 모든 구조 및 기기의 이벤트가 게시됩니다.

이벤트 생성

모든 트레잇 필드 변경사항에 대해 이벤트가 생성되며, 그중 일부는 자동이고 일부는 수동입니다.

예를 들어 Nest Thermostat 근처의 주변 온도가 변경되면Temperature 트레잇의 이벤트가 새 ambientTemperatureCelsius 값과 함께 자동으로 전송됩니다.

키를 수동으로 생성하려면 다음 중 하나를 실행하세요.

  1. Nest Thermostat의 모드를 변경하는 등 기기의 상태를 실제로 변경합니다.
  2. Google Nest Cam Indoor에서 움직임, 사람, 소리와 같은 활동을 트리거합니다.
  3. SDM API를 사용하여 기기 명령어를 실행합니다.

메시지 보기

이벤트 메시지는 Google Cloud 프로젝트의 Pub/Sub 구독 섹션에서 볼 수 있습니다.

Google Cloud Pub/Sub 구독으로 이동

  1. 앞에서 만든 구독 ID를 클릭합니다.
  2. 구독 세부정보 화면에 수신 확인되지 않은 메시지 수 차트의 활동이 표시됩니다. 이는 구독에 이벤트 메시지가 전달되었음을 나타냅니다. 활동이 표시되지 않으면 잠시 기다리거나 이벤트를 더 생성하세요.
  3. 메시지 보기를 클릭하여 메시지 패널을 엽니다.
  4. 가져오기를 클릭하여 메시지를 확인합니다. 이벤트를 생성하는 데 사용한 작업과 일치해야 합니다.

Cloud Shell에서 기본 pull 명령어를 사용하여 메시지를 볼 수도 있습니다.

gcloud pubsub subscriptions pull subscription-id

구독 유형, SDM API에서 전송하는 이벤트 유형, 사용 방법에 관한 자세한 내용은 이벤트를 참고하세요.

메일 관리

구독을 깔끔하게 유지하고 다른 구독자에게 메시지가 중복으로 전송되지 않도록 하려면 메시지를 정기적으로 확인하고 삭제해야 합니다. 모든 구독 메시지는 Pub/Sub 구독 섹션에서 수동으로 삭제할 수 있습니다.

Google Cloud Pub/Sub 구독으로 이동

  1. 구독 ID를 클릭합니다.
  2. 확인하고 삭제하는 방법에는 다음과 같은 몇 가지가 있습니다.
    1. 메시지 보기를 클릭하여 메시지 패널을 엽니다. 확인 메시지 사용 설정 체크박스를 선택하고 가져오기를 클릭하여 모든 메시지를 확인하고 확인합니다.
    2. 메시지 삭제를 클릭하여 메시지를 확인하지 않고 확인하여 기존 메시지를 모두 삭제합니다. 삭제를 클릭하여 확인합니다.

Cloud Shell에서 기본 pull 명령어와 함께 --auto-ack 플래그를 사용하여 메시지를 삭제할 수도 있습니다.

gcloud pubsub subscriptions pull subscription-id --auto-ack

구독 관리

구독은 구독 속성 사용에 설명된 대로 다양한 방법으로 구성할 수 있습니다.

구독 및 메시지를 관리하는 방법은 개발자마다 다르지만 프로덕션 애플리케이션의 경우 지금까지 이 빠른 시작 가이드에서 사용한 사용자 계정 대신 인증에 서비스 계정을 사용하는 것이 좋습니다. 서비스 계정은 사람이 아닌 애플리케이션 또는 가상 머신에서 사용하며 고유한 계정 키가 있습니다.

Device Access를 사용한 서비스 계정 인증에 관한 자세한 내용은 이벤트를 참고하세요.

이전
3. API 사용