Standorte aus dem Unternehmensprofil aufnehmen

Unternehmensprofil ist ein kostenloses und einfach zu verwendendes Tool, mit dem Unternehmen und Organisationen die Onlinepräsenz auf Google, einschließlich der Google Suche und Maps, verwalten können.

Die Google Business Profile API bietet eine Oberfläche zur Verwaltung von Standortinformationen auf Google. Ein Unternehmen kann einem anderen Unternehmen über OAuth-Einwilligung Zugriff gewähren, um sein Profil in seinem Namen zu verwalten.

Verwaltete Unternehmen sind bereits durch das Unternehmensprofil bestätigt worden. Sie können den OAuth-Vorgang für das Unternehmensprofil ausweiten, um diese Unternehmen auf Business Messages einzurichten und sie automatisch für die Einführung in Business Messages zu bestätigen.

Dies ist eine skalierbarere und schnellere Methode, um Business Messages zu starten. Sie wird empfohlen, um die Nachrichtenfunktion für einen Standort in einem Unternehmensprofil zu aktivieren.

Voraussetzungen

Sie müssen ein Google Unternehmensprofil-Partner mit Zugriff auf die Google Business Profile APIs sein. Wenn das nicht der Fall ist, folgen Sie den Voraussetzungen für das Unternehmensprofil, um Zugriff zu beantragen.

Sobald Sie Zugriff auf die Google Business Profile API haben, folgen Sie der Anleitung für die grundlegende Einrichtung und die OAuth-Einrichtung, bevor Sie fortfahren.

Business Messages für einen bestätigten Standort im Unternehmensprofil aktivieren

Das folgende Diagramm zeigt, wie Ihr Webdienst die Standortbestätigung eines Unternehmensprofils für einen Business Messages-Agent nutzen kann. Eine ausführliche Anleitung finden Sie unten.

1. Aktualisieren Sie die API-Bereiche in Ihrem bestehenden OAuth-Zustimmungsvorgang, bei dem der Inhaber eines Google Unternehmensprofil-Kontos Ihnen die Berechtigung zum Aufrufen der Google Business Profile APIs gewährt.

   • https://www.googleapis.com/auth/business.manage
   • https://www.googleapis.com/auth/businesscommunications

   Beide Bereiche sind erforderlich, um den Agent und die Standorte automatisch zu bestätigen.

2. Erstellen Sie einen Agent mit einem displayName, der dem Namen von mindestens einem der Google Unternehmensprofil-Einträge entspricht, die zu den OAuth-Anmeldedaten gehören, die Sie im vorherigen Schritt erhalten haben. Mit der Google Business Profile API können Sie die Namen von Unternehmen ermitteln.

   Für den Namensabgleich

   • Die Groß- und Kleinschreibung wird nicht berücksichtigt.
   • Der vollständige Name des Agents muss genau mit dem ersten Wort oder den ersten Wörtern im Standortnamen des Unternehmensprofils übereinstimmen. Ein Agent mit dem Namen „GBP Bakery“ stimmt z. B. mit „Gbp Bakery Mountain View“, „Gbp Bakery“ und „gbp bakeryonnevale“ überein, aber nicht mit „Bakery San Francisco“.

3. Erstellen Sie für jeden Standort im Unternehmensprofil einen Standort mit demselben placeId. Der placeId für einen Unternehmensprofil-Standort ist im Objekt LocationKey enthalten, wenn ein Standort aus der Google Business Profile API abgerufen wird.

4. Fordern Sie mit dem von Ihnen erstellten Agent und dem erhaltenen OAuth-Token eine Agent-Bestätigung an.

   Hinweis: Sie müssen das abgerufene OAuth-Token mit zwei Bereichen und nicht den Dienstkontoschlüssel Ihres Projekts verwenden.

   Für die Überprüfungsanfrage sind Kontaktdaten für Marken erforderlich. Es wird jedoch keine E-Mail an die Marke gesendet, wenn der Agent-Name mit dem Namen im Unternehmensprofil übereinstimmt und Sie das OAuth-Token mit den richtigen Bereichen erhalten haben.

   Wenn Sie dies korrekt getan haben, sollte die Ausgabe der Überprüfungsanfrage sofort ein verificationState von VERIFICATION_STATE_VERIFIED zurückgeben. Wenn verificationState einen anderen Wert zurückgibt, haben Sie beim Senden der Anfrage wahrscheinlich nicht das richtige OAuth-Token verwendet oder der Agent konnte keinem Standort im Unternehmensprofil zugeordnet werden.

5. Fordern Sie mit demselben OAuth-Token die Bestätigung des Standorts für alle Standorte an, die dem Unternehmen im Unternehmensprofil gehören.

   Genau wie bei der Agent-Bestätigung sollte die Ausgabe der Überprüfungsanfrage sofort ein verificationState von VERIFICATION_STATE_VERIFIED zurückgeben, wenn Sie dies richtig getan haben. Wenn verificationState einen anderen Wert zurückgibt, haben Sie wahrscheinlich nicht das richtige OAuth-Token verwendet, als die Anfrage gesendet wurde, oder der Standort des Unternehmensprofils ist kein beanspruchtes und bestätigtes Unternehmen.

6. Starten Sie den Agent mit dem Einstiegspunkt LOCATION.

7. Aktivieren Sie die Nachrichtenfunktion für bestimmte Standorte, indem Sie die Standorte starten, die in der Google Suche und auf Google Maps verfügbar sein sollen. Nach Beginn des Einführungsprozesses können Nutzer innerhalb weniger Stunden Nachrichten zu den einzelnen Standorten abrufen.

Nachdem Sie diese Schritte ausgeführt haben, werden alle Nachrichten von Nutzern an Ihren registrierten Business Messages-Webhook gesendet. Sie müssen Antworten mit der Business Messages API an Nutzer senden.