Q&A API가 출시되었습니다. 이전 작업이 필요하며, 지원 중단된 엔드포인트와 관련된 자세한 내용은 지원 중단 일정을 참고하세요.
Notifications API v1.1이 출시되었습니다. 자세한 내용은 변경 로그를 참고하세요. 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. 알림을 받으려면 My Business Notifications API에서 accounts.updateNotificationSetting 엔드포인트를 호출합니다. 호출 시 Cloud Pub/Sub에서 만든 주제 이름을 사용하여 비즈니스 프로필 계정을 주제에 연결합니다.
  6. (선택사항) 알림을 받을 각 비즈니스 프로필 계정에 대해 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?updateMask={commaSeparatedFieldsToUpdate}

{
  pubsubTopic: your/pubsub/topicName
}

알림 설정 삭제

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

HTTP
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic