Hinweis: Es stehen größere Änderungen an der API an, für die Migrationen erforderlich sein werden. Aktuelle Informationen finden Sie auf der Seite Anstehende Releases der Google My Business API und im Zeitplan für die Einstellung. Sie können sich auch auf die Mailingliste setzen lassen, um entsprechende Benachrichtigungen zu erhalten.

Benachrichtigungen in Echtzeit verwalten

In der My Business Notifications API werden Benachrichtigungen im Cloud Pub/Sub-Dienst veröffentlicht. Nachdem Sie Cloud Pub/Sub eingerichtet und ein Thema erstellt haben, können Sie die folgenden Vorgänge für Benachrichtigungen ausführen:

Unter anderem werden neue oder aktualisierte Rezensionen, Fragen und Antworten, Medienuploads, Google-Updates zur Überprüfung und Änderungen des Standortstatus unterstützt. Das Objekt NotificationType listet die verfügbaren Benachrichtigungstypen auf und beschreibt sie.

Hinweis

Bevor Sie die My Business Notifications API verwenden können, müssen Sie Ihre Anwendung registrieren und OAuth 2.0-Anmeldedaten abrufen. Weitere Informationen zu den ersten Schritten mit der API finden Sie unter Grundlegende Einrichtung.

Cloud Pub/Sub einrichten

So richten Sie API-Benachrichtigungen mit Cloud Pub/Sub ein:

  1. Folgen Sie der Cloud Pub/Sub-Anleitung, um Ihre Anwendung einzurichten.
  2. Erstellen Sie ein Thema in Ihrem Cloud Pub/Sub-Projekt und notieren Sie sich den Namen des Themas.
  3. Gewähren Sie mybusiness-api-pubsub@system.gserviceaccount.com mindestens pubsub.topics.publish-Berechtigungen.
  4. Folgen Sie der Anleitung unter Abonnentenübersicht, um Push- oder Pull-Benachrichtigungen einzurichten.
  5. Rufen Sie zum Empfangen von Benachrichtigungen den Endpunkt accounts.updateNotificationSetting in der Google My Business API auf. Verwenden Sie dabei den Namen des Themas, das Sie in Cloud Pub/Sub erstellt haben, um Ihr GMB-Konto mit dem Thema zu verknüpfen.
  6. Optional: Wiederholen Sie Schritt 5 für jedes Google My Business-Konto, für das Sie Benachrichtigungen erhalten möchten.

Benachrichtigungseinstellungen abrufen

Der Endpunkt accounts.getNotificationSetting gibt die aktuellen Cloud Pub/Sub-Benachrichtigungseinstellungen für ein Konto zurück. In der folgenden Tabelle sehen Sie, wie er aufgerufen wird:

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

Benachrichtigungseinstellungen aktualisieren

Der Endpunkt accounts.updateNotificationSetting aktualisiert die Cloud Pub/Sub-Benachrichtigungseinstellungen, die einem Konto zugewiesen sind. In der folgenden Tabelle sehen Sie, wie er aufgerufen wird:

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

{
  pubsubTopic: your/pubsub/topicName
}

Benachrichtigungseinstellungen löschen

Wenn accounts.updateNotificationSetting mit einem leeren pubsubTopic aufgerufen wird, werden die Cloud Pub/Sub-Benachrichtigungseinstellungen aus einem Konto gelöscht. In der folgenden Tabelle sehen Sie, wie er aufgerufen wird:

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