Zarządzanie powiadomieniami w czasie rzeczywistym

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:

  1. Postępuj zgodnie z przewodnikiem Cloud Pub/Sub, aby skonfigurować aplikację.
  2. Utwórz temat w projekcie Cloud Pub/Sub i zapisz jego nazwę.
  3. Przyznaj uprawnienia co najmniej pubsub.topics.publish użytkownikowi mybusiness-api-pubsub@system.gserviceaccount.com.
  4. Aby skonfigurować powiadomienia push lub pull, postępuj zgodnie z instrukcjami w przewodniku po subskrybentach.
  5. 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.
  6. (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ć:

HTTP
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ć:

HTTP
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ć:

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