Häufig gestellte Fragen

Was sind die GPB APIs?

Die Google Business Profile APIs (GBP APIs) sind Programmierschnittstellen, mit denen Entwickler Anwendungen für die Verwaltung ihres Google Unternehmensprofil-Kontos und ihrer Standortdaten erstellen können. Mit den APIs können Händler oder deren Vertreter festlegen, wie ihre Daten auf Google dargestellt werden, und steuern, wer ihre Daten mitverwalten darf. Auch von Nutzern erstellte Inhalte wie Fotos, Beiträge und Rezensionen lassen sich über die APIs verwalten.

Die GPB APIs bieten weitgehend dieselben Funktionen wie die UI von Google Unternehmensprofil sowie einige API-spezifische Zusatzfunktionen. Bei der Nutzung von APIs und UI ist gleichermaßen mit Google-Updates zu rechnen.

Wer kann Zugriff auf die GPB APIs erhalten?

Die GPB APIs sind nicht öffentlich verfügbar. Nutzer müssen den Zugriff darauf anfordern, um sie nutzen zu können. Alle natürlichen Personen oder Unternehmen, die einen legitimen geschäftlichen Grund für den Zugriff auf die GPB APIs nachweisen können, erhalten Zugriff. Einige Empfehlungen zum Nachweis der Legitimität eines Unternehmens:

  • Verwenden Sie eine gültige geschäftliche E-Mail-Adresse, die mit Ihrer Unternehmensdomain verbunden ist.
  • Halten Sie die Website Ihres Unternehmens auf dem neuesten Stand.

Können Nutzer mit Zugriff auf die GPB APIs Daten aus allen Unternehmensprofilen abfragen?

Nein. Selbst wenn Sie Zugriff auf die GPB APIs erhalten, können Sie nur Daten aus Unternehmensprofilen abfragen, auf die Sie auch Zugriff haben.

Welche Richtlinien gelten für Nutzer der GPB APIs?

Partner müssen sich an die Richtlinien für Google Unternehmensprofil sowie an alle Richtlinien und Nutzungsbedingungen für die APIs halten.

Wie erhalten Nutzer Zugriff auf die GPB APIs?

Damit Sie Ihre erste Clientanwendung erstellen können, müssen Sie zuerst Folgendes tun:

  1. ein Google-Konto erstellen
  2. Google Unternehmensprofil ausprobieren
  3. ein Projekt in der Google API Console erstellen
  4. Zugriff auf die API anfordern (Anfragen werden innerhalb von 14 Tagen bearbeitet)

Wie erhalten Nutzer Zugriff auf eine bestimmte GBP API?

Es gibt acht Business Profile APIs, die in der Google API Console aktiviert werden müssen:

  • Google My Business API 4.9, die die folgenden wichtigen API-Aufrufe enthält:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • My Business Account Management API
  • My Business Lodging API
  • My Business Place Actions API
  • My Business Notifications API
  • My Business Verifications API
  • My Business Business Information API
  • My Business Q&A API
  • Business Profile Performance API

Wird die Zugriffsanfrage eines Nutzers genehmigt, wird ihm ein Standardkontingent für alle acht APIs zugewiesen.

Wie funktioniert der Zugriff auf die GPB APIs?

Der Zugriff auf die GPB APIs wird auf Ebene eines Google Cloud-Projekts gewährt. Hat Nutzer A Zugriff auf die GPB APIs für Projektnummer 12345678 angefordert, so wird der Zugriff für Projektnummer 12345678 gewährt. Somit können alle Nutzer, einschließlich Nutzer A, die Zugriff auf das Google Cloud-Projekt haben, die GPB APIs aufrufen. Partner sollten den Zugriff auf das Google Cloud-Projekt nur nach Bedarf gewähren, um Missbrauch zu vermeiden.

Gibt es eine Zusammenfassung der APIs und zugehöriger Beispielfunktionen?

In der folgenden Tabelle finden Sie Informationen zu den einzelnen APIs und ihren Funktionen.

API Referenzdokumentation Beispielfunktionen
Account Management API Dokumentation
  • Zugriff auf einen Standort verwalten.
  • Erstellt ein Konto mit dem angegebenen Namen und Typ unter dem angegebenen übergeordneten Element.
  • Listet alle Konten für den authentifizierten Nutzer auf.
  • Listet ausstehende Einladungen für das angegebene Konto auf.
  • Verschiebt einen Standort von einem Konto des Nutzers in ein anderes Konto.
  • Aktualisiert den Administrator des angegebenen Standorts.
Business Information API Dokumentation
  • Lebenszyklus von Profilen verwalten und Informationen zum Unternehmen im Unternehmensprofil hinzufügen oder verwalten.
  • Ermöglicht es Händlern, Unternehmensprofile zu erstellen, zu aktualisieren oder zu löschen.
  • Ermöglicht es Händlern, Profilattribute abzurufen oder zu aktualisieren.
  • Ermöglicht es Händlern, Ketten und Profilkategorien abzurufen oder zu suchen.
Lodging API Dokumentation
  • Ermöglicht die Verwaltung von Unterkunftsdaten, z. B. zur Ausstattung, und Richtlinien für Unternehmen auf Google. Die API ist speziell für Anbieter von Unterkünften wie beispielsweise Hotels vorgesehen. Ermöglicht es Entwicklern, die Unterkunftsattribute eines Unternehmensprofils zu aktualisieren.
Place Actions API Dokumentation
  • Ermöglicht die Verwaltung von Links für ortsbezogene Aktionen von Unternehmen.
  • Nutzer weiterleiten, damit sie Aktionen ausführen und z. B. Termine buchen, einen Tisch reservieren oder Essen bestellen.
Notifications API Dokumentation
  • Ermöglicht die Verwaltung der Benachrichtigungseinstellungen für bestimmte Konten.
Verifications API Dokumentation
  • Startet die Bestätigung für einen Standort.
  • Zeigt alle verfügbaren Bestätigungsoptionen für einen Standort in einer bestimmten Sprache an.
Q&A API Dokumentation
  • Ermöglicht die Verwaltung der Fragen und Antworten eines Standorts.
Business Profile Performance API Dokumentation
  • Ermöglicht es Händlern, Leistungsstatistiken zu ihrem Unternehmensprofil abzurufen.
  • Dazu gehören z. B. Impressionen, Abrufe der Wegbeschreibung, Anrufklicks, Websiteklicks, Buchungen, Essensbestellungen und Interaktionen mit dem Menü.
Media API Dokumentation
  • Ermöglicht es API-Entwicklern, Fotos und Videos für ein Unternehmensprofil hochzuladen.
Reviews API Dokumentation
  • Ermöglicht es Händlern, Rezensionen zu erhalten und auf Rezensionen in einem Unternehmensprofil zu antworten.
Local Posts API Dokumentation
  • Ermöglicht es Händlern, lokale Beiträge zu erhalten, zu erstellen oder zu aktualisieren.
FoodMenus API Dokumentation
  • Ermöglicht es Händlern, Speisekarten für ein Unternehmensprofil abzurufen, zu erstellen oder zu aktualisieren.

Wie können Partner ihre Kontostruktur für die Nutzung der GPB APIs einrichten?

Wenn Sie ein Drittanbieter sind, der Einträge für Unternehmen verwaltet:

Wie autorisieren Unternehmen einen GBP API-Partner, ihr Unternehmensprofil zu verwalten?

Unternehmen haben zwei Möglichkeiten, Drittanbietern Zugriff zu gewähren:

  • OAuth-Einrichtung: In diesem Leitfaden finden Sie Informationen dazu, wie Drittanbieterplattformen die Anmeldedaten von Händlern verwenden, um Daten aus dem Unternehmensprofil im Namen des Händlers oder Unternehmens zu bearbeiten und darauf zuzugreifen.

  • Als Inhaber oder Administrator hinzufügen: Wird ein Drittanbieter vom Händler, der der primäre Inhaber des Unternehmensprofils sein muss, als Administrator des Unternehmensprofils hinzugefügt, muss der Drittanbieter nicht die Anmeldedaten des Händlers verwenden, um die GBP APIs zu nutzen und Daten aus dem Unternehmensprofil zu bearbeiten und darauf zuzugreifen.

    Hinweis: Wir empfehlen dringend, dass sich Drittanbieter nicht selbst als Inhaber des Unternehmensprofils hinzufügen, sondern nur als Administrator.

Ist bei Unternehmen mit 10 oder mehr Standorten eine Bulk-Bestätigung möglich?

Ja. Bei 10 oder mehr Standorten können Sie eine Bulk-Bestätigung anfordern. Nach der Bestätigung können die veröffentlichten Standorte von Ketten mit den GBP APIs genau wie andere Standorte verwaltet werden – mit einigen Ausnahmen. Beispielsweise werden Site-Manager anders behandelt und können sich selbst Franchise-Standorten hinzufügen.

Was sind die Kontingente der einzelnen APIs?

Die Standardkontingente finden Sie auf der Seite Nutzungslimits. Falls das nicht ausreicht, können Sie einen Antrag auf Kontingenterhöhung stellen.

Was für ein Kontingent kann ich maximal beantragen?

Das Kontingent ist eine begrenzte Ressource. Das Supportteam für die GBP APIs sieht sich Ihre bisherige Kontingentnutzung an, um zu entscheiden, ob Ihrem Antrag auf Kontingenterhöhung stattgegeben werden kann. Entspricht Ihre durchschnittliche Nutzung weniger als 70 % Ihres aktuellen Kontingents, kann Ihnen eine weitere Erhöhung verweigert werden.

Können GBP API-Partner ein Testkonto für die Produktion erstellen?

Nein. Leider gibt es keine direkte Möglichkeit, ein fiktives Unternehmensprofil zu Testzwecken für die Produktion zu erstellen, weder über die UI noch über die APIs von Google Unternehmensprofil.

Entsprechende Profile werden in der Regel von der Moderation gemeldet und gesperrt. Wir raten Ihnen, entweder ein Kundenprofil zu verwenden und es nach Feierabend zu bearbeiten (unter der Voraussetzung, dass Sie keine primären Informationen wie Name, Adresse oder Kategorie ändern) oder ein Profil für Ihren Hauptsitz zu erstellen. Wenn Sie eine API-Antwort testen möchten, um ein Profil zu bestätigen, oder eine andere Aktion, für die ein Produktionsprofil erforderlich ist, können Sie API-Antworten simulieren.