Zarządzanie powiadomieniami w czasie rzeczywistym

W interfejsie My Business Notifications 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:

Obsługiwane są nowe i zaktualizowane opinie, pytania i odpowiedzi, przesyłanie multimediów, aktualizacje Google do sprawdzenia, zmiany stanu lokalizacji i inne. Obiekt NotificationType wymienia i opisuje dostępne typy powiadomień.

Zanim zaczniesz

Aby korzystać z interfejsu My Business Notifications API, zarejestruj swoją aplikację i uzyskaj uprawnienia OAuth 2.0. Szczegółowe informacje o tym, jak zacząć korzystać z interfejsu API, znajdziesz w artykule Konfiguracja podstawowa.

Konfiguracja Cloud Pub/Sub

Aby skonfigurować powiadomienia API za pomocą Cloud Pub/Sub, wykonaj te czynności:

  1. Aby skonfigurować aplikację, postępuj zgodnie z instrukcjami dotyczącymi Cloud Pub/Sub.
  2. Utwórz temat w projekcie Cloud Pub/Sub i zapisz nazwę utworzonego tematu.
  3. Przyznaj uprawnienia do konta mybusiness-api-pubsub@system.gserviceaccount.com co najmniej na poziomie pubsub.topics.publish.
  4. Aby skonfigurować powiadomienia push lub pull, postępuj zgodnie z instrukcjami podanymi w przewodniku na temat subskrypcji.
  5. Aby otrzymywać powiadomienia, wywołaj punkt końcowy accounts.updateNotificationSetting w interfejsie API powiadomień Google Moja Firma. W wywołaniu użyj nazwy tematu utworzonego w Cloud Pub/Sub, aby połączyć konto Profilu Firmy z tematem.
  6. (Opcjonalnie) Powtórz krok 5 w przypadku każdego konta profilu firmy, na które chcesz otrzymywać powiadomienia.

Pobieranie ustawień powiadomień

Punkt końcowy accounts.getNotificationSettingzwraca bieżące ustawienia powiadomień Cloud Pub/Sub dla konta. W tabeli poniżej pokazujemy, jak go wywołać:

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

Aktualizowanie ustawień powiadomień

Punkt końcowy accounts.updateNotificationSetting aktualizuje ustawienia powiadomień Cloud Pub/Sub powiązane z kontem. W tabeli poniżej pokazujemy, jak go wywołać:

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

{
  pubsubTopic: your/pubsub/topicName
}

Usuwanie ustawień powiadomień

Wywołanie accounts.updateNotificationSetting z pustym pubsubTopic powoduje usunięcie ustawień powiadomień Cloud Pub/Sub z konta. W tabeli poniżej pokazujemy, jak go wywołać:

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