주의: 이전 작업을 필요로 하는 중대한 변경사항이 곧 API에 적용될 예정입니다. 예정된 출시 페이지와 지원 중단 일정 페이지에서 업데이트 사항을 수시로 확인하세요. 또한 Google 메일링 리스트에 가입하여 업데이트 사항을 받아볼 수도 있습니다.

실시간 알림 관리

My Business Notifications API에서 알림은 Cloud Pub/Sub 서비스에 게시됩니다. Cloud Pub/Sub를 설정하고 주제를 생성한 후 알림에 대해 다음과 같은 작업을 할 수 있습니다.

신규 또는 업데이트된 리뷰, 질문과 답변, 미디어 업로드, 검토할 Google 업데이트, 위치 상태 변경 등이 지원됩니다. NotificationType 객체는 사용 가능한 알림 유형을 나열하고 설명합니다.

시작하기 전에

My Business Notifications API를 사용하려면 애플리케이션을 등록하고 OAuth 2.0 사용자 인증 정보를 받아야 합니다. My Business Notifications API를 시작하는 방법에 대해 자세히 알아보려면 기본 설정을 참고하세요.

Cloud Pub/Sub 설정

Cloud Pub/Sub로 API 알림을 설정하려면 다음 단계를 따르세요.

  1. Cloud Pub/Sub 가이드에 따라 애플리케이션을 설정합니다.
  2. Cloud Pub/Sub 프로젝트에서 주제를 만들고 생성된 주제의 이름을 기록합니다.
  3. mybusiness-api-pubsub@system.gserviceaccount.com에 최소한 pubsub.topics.publish 권한을 부여합니다.
  4. 구독자 개요 가이드에 따라 푸시 또는 풀 알림을 설정합니다.
  5. 알림을 받으려면 Google My Business API에서 accounts.updateNotificationSetting 엔드포인트를 호출합니다. 호출 시 Cloud Pub/Sub에서 만든 주제 이름을 사용하여 GMB 계정을 주제에 연결합니다.
  6. (선택사항) 알림을 받을 각 Google 마이 비즈니스 계정에 대해 5단계를 반복합니다.

알림 설정 가져오기

accounts.getNotificationSetting 엔드포인트는 계정의 현재 Cloud Pub/Sub 알림 설정을 반환합니다. 다음 표에는 이러한 엔드포인트를 호출하는 방법이 나와 있습니다.

HTTP
GET
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting

알림 설정 업데이트

accounts.updateNotificationSetting 엔드포인트는 계정과 연결된 Cloud Pub/Sub 알림 설정을 업데이트합니다. 다음 표에는 이러한 엔드포인트를 호출하는 방법이 나와 있습니다.

HTTP
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting

{
  pubsubTopic: your/pubsub/topicName
}

알림 설정 삭제

pubsubTopic으로 accounts.updateNotificationSetting을 호출하면 계정에서 Cloud Pub/Sub 알림 설정이 삭제됩니다. 다음 표에는 이러한 엔드포인트를 호출하는 방법이 나와 있습니다.

HTTP
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting