Die Business Profile Performance API ist jetzt verfügbar. Die Migration ist erforderlich.
Lesen Sie den Zeitplan für die Einstellung und die Anleitung, um von älteren, eingestellten v4 APIs zu neuen v1 APIs zu migrieren.
Hilf uns, das Essensangebot zu verbessern, indem du an dieser Umfrage teilnimmst. So kannst du uns mitteilen, welche Attribute zu Orten, Speisekarten und Gerichten du anbieten kannst.

Benachrichtigungen in Echtzeit verwalten

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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, Medien-Uploads, Google-Updates zur Überprüfung und Änderungen des Standortstatus unterstützt. Das Objekt NotificationType listet die verfügbaren Benachrichtigungstypen auf und beschreibt sie.

Hinweis

Damit 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. Wenn Sie Benachrichtigungen erhalten möchten, rufen Sie den Endpunkt accounts.updateNotificationSetting in der My Business Notifications API auf. Verwenden Sie dabei den Namen des Themas, das Sie in Cloud Pub/Sub erstellt haben, um Ihr Google Unternehmensprofil-Konto mit dem Thema zu verknüpfen.
  6. Optional: Wiederholen Sie Schritt 5 für jedes Unternehmensprofil-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. Die folgende Tabelle zeigt, wie sie 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 zugeordnet sind. Die folgende Tabelle zeigt, wie sie aufgerufen wird:

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

{
  pubsubTopic: your/pubsub/topicName
}

Benachrichtigungseinstellungen löschen

Wenn Sie accounts.updateNotificationSetting mit einem leeren pubsubTopic aufrufen, werden die Cloud Pub/Sub-Benachrichtigungseinstellungen aus einem Konto gelöscht. Die folgende Tabelle zeigt, wie sie aufgerufen wird:

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