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 알림을 설정하려면 다음 단계를 따르세요.
- Cloud Pub/Sub 가이드에 따라 애플리케이션을 설정합니다.
- Cloud Pub/Sub 프로젝트에서 주제를 만들고 생성된 주제의 이름을 기록합니다.
- mybusiness-api-pubsub@system.gserviceaccount.com에
최소한
pubsub.topics.publish권한을 부여합니다. - 구독자 개요 가이드에 따라 푸시 또는 풀 알림을 설정합니다.
- 알림을 받으려면 My Business Notifications API에서
accounts.updateNotificationSetting엔드포인트를 호출합니다. 호출 시 Cloud Pub/Sub에서 만든 주제 이름을 사용하여 비즈니스 프로필 계정을 주제에 연결합니다. - (선택사항) 알림을 받을 각 비즈니스 프로필 계정에 대해 5단계를 반복합니다.
알림 설정 가져오기
accounts.getNotificationSetting
엔드포인트는 계정의 현재 Cloud Pub/Sub 알림 설정을
반환합니다. 다음 표에는 이러한 엔드포인트를 호출하는 방법이 나와 있습니다.
GET
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting
알림 설정 업데이트
accounts.updateNotificationSetting
엔드포인트는 계정과 연결된 Cloud Pub/Sub 알림 설정을
업데이트합니다. 다음 표에는 이러한 엔드포인트를 호출하는 방법이 나와 있습니다.
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask={commaSeparatedFieldsToUpdate}
{
pubsubTopic: your/pubsub/topicName
}
알림 설정 삭제
빈 pubsubTopic으로 accounts.updateNotificationSetting을 호출하면 계정에서 Cloud Pub/Sub 알림 설정이 삭제됩니다.
다음 표에는 이러한 엔드포인트를 호출하는 방법이 나와 있습니다.
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic