W interfejsie My Business Notification API powiadomienia są publikowane w usłudze Cloud Pub/Sub. Po skonfigurowaniu Cloud Pub/Sub i utworzeniu tematu możesz wykonywać te operacje na powiadomieniach:
Dostępne są nowe i zaktualizowane opinie, pytania i odpowiedzi, przesłane pliki multimedialne, aktualizacje Google dotyczące sprawdzania, zmiany stanu lokalizacji itp. Obiekt NotificationType zawiera listę i opis dostępnych typów powiadomień.
Zanim zaczniesz
Aby korzystać z interfejsu My Business Notification API, zarejestruj aplikację i uzyskaj dane logowania OAuth 2.0. Więcej informacji o tym, jak zacząć korzystać z interfejsu API, znajdziesz w artykule o podstawowej konfiguracji.
Konfiguracja Cloud Pub/Sub
Aby skonfigurować powiadomienia interfejsu API w Cloud Pub/Sub, wykonaj te czynności:
- Postępuj zgodnie z przewodnikiem Cloud Pub/Sub, aby skonfigurować aplikację.
- Utwórz temat w projekcie Cloud Pub/Sub i zapisz jego nazwę.
- Przyznaj uprawnienia co najmniej
pubsub.topics.publish
użytkownikowi mybusiness-api-pubsub@system.gserviceaccount.com. - Aby skonfigurować powiadomienia push lub pull, postępuj zgodnie z instrukcjami w przewodniku po subskrybentach.
- Aby otrzymywać powiadomienia, wywołaj punkt końcowy
accounts.updateNotificationSetting
w interfejsie My Business Notification API. W rozmowie użyj nazwy tematu utworzonej w Cloud Pub/Sub, aby połączyć z tematem konto w Profilu Firmy. - (Opcjonalnie) Powtórz krok 5 w przypadku każdego konta w Profilu Firmy, o którym chcesz otrzymywać powiadomienia.
Pobierz ustawienia powiadomień
Punkt końcowy accounts.getNotificationSetting
zwraca bieżące ustawienia powiadomień Cloud Pub/Sub dla konta. Poniższa tabela pokazuje, jak to zrobić:
GET https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting
Zaktualizuj ustawienia powiadomień
Punkt końcowy accounts.updateNotificationSetting
aktualizuje ustawienia powiadomień Cloud Pub/Sub powiązane z kontem. Poniższa tabela pokazuje, jak to zrobić:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask={commaSeparatedFieldsToUpdate} { pubsubTopic: your/pubsub/topicName }
Usuń ustawienia powiadomień
Wywołanie accounts.updateNotificationSetting
z pustym pubsubTopic
powoduje usunięcie z konta ustawień powiadomień Cloud Pub/Sub.
Poniższa tabela pokazuje, jak to zrobić:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic