Google My Business API

Über die Google My Business API lassen sich Informationen zu Unternehmensstandorten auf Google verwalten.

Dienst: mybusiness.googleapis.com

Um diesen Dienst aufzurufen, empfehlen wir die Verwendung der von Google bereitgestellten Clientbibliotheken. Wenn Ihre Anwendung Ihre eigenen Bibliotheken verwenden muss, um diesen Dienst aufzurufen, verwenden Sie die folgenden Informationen, wenn Sie die API-Anfragen stellen.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente haben. Der Dienst bietet die folgenden Discovery-Dokumente:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://mybusiness.googleapis.com

REST-Ressource: v4.accounts

Methoden
create
(deprecated)
POST /v4/accounts
Erstellt ein Konto mit dem angegebenen Namen und Typ unter dem angegebenen übergeordneten Element.
deleteNotifications
(deprecated)
DELETE /v4/{name=accounts/*/notifications}
Löscht die Pub/Sub-Benachrichtigungseinstellungen für das Konto.
generateAccountNumber
(deprecated)
POST /v4/{name=accounts/*}:generateAccountNumber
Generiert eine Kontonummer für dieses Konto.
get
(deprecated)
GET /v4/{name=accounts/*}
Ruft das angegebene Konto ab.
getNotifications
(deprecated)
GET /v4/{name=accounts/*/notifications}
Gibt die Pub/Sub-Benachrichtigungseinstellungen für das Konto zurück.
list
(deprecated)
GET /v4/accounts
Listet alle Konten für den authentifizierten Nutzer auf.
listRecommendGoogleLocations GET /v4/{name=accounts/*}:recommendGoogleLocations
Alle GoogleLocations auflisten, die dem angegebenen Unternehmensprofil-Konto empfohlen wurden.
update
(deprecated)
PUT /v4/{name=accounts/*}
Aktualisiert das angegebene Unternehmenskonto.
updateNotifications
(deprecated)
PUT /v4/{name=accounts/*/notifications}

Legt die Pub/Sub-Benachrichtigungseinstellungen für das Konto fest, mit dem Google Unternehmensprofil darüber informiert wird, zu welchem Thema Pub/Sub-Benachrichtigungen gesendet werden:

  • Neue Rezensionen für Standorte, die über das Konto verwaltet werden.

REST-Ressource: v4.accounts.admins

Methoden
create
(deprecated)
POST /v4/{parent=accounts/*}/admins
Lädt den angegebenen Nutzer ein, Administrator für das angegebene Konto zu werden.
delete
(deprecated)
DELETE /v4/{name=accounts/*/admins/*}
Entfernt den angegebenen Administrator aus dem angegebenen Konto.
list
(deprecated)
GET /v4/{parent=accounts/*}/admins
Listet die Administratoren für das angegebene Konto auf.
patch
(deprecated)
PATCH /v4/{name=accounts/*/admins/*}
Aktualisiert den Administrator des angegebenen Kontoadministrators.

REST-Ressource: v4.accounts.invitations

Methoden
accept
(deprecated)
POST /v4/{name=accounts/*/invitations/*}:accept
Nimmt die angegebene Einladung an.
decline
(deprecated)
POST /v4/{name=accounts/*/invitations/*}:decline
Lehnt die angegebene Einladung ab.
list
(deprecated)
GET /v4/{parent=accounts/*}/invitations
Listet ausstehende Einladungen für das angegebene Konto auf.

REST-Ressource: v4.accounts.locations

Methoden
associate POST /v4/{name=accounts/*/locations/*}:associate
Verknüpft einen Standort mit einer Orts-ID.
batchGet POST /v4/{name=accounts/*}/locations:batchGet
Ruft alle angegebenen Standorte im angegebenen Konto ab.
batchGetReviews POST /v4/{name=accounts/*}/locations:batchGetReviews
Gibt die paginierte Liste mit Rezensionen für alle angegebenen Standorte zurück.
clearAssociation POST /v4/{name=accounts/*/locations/*}:clearAssociation
Hebt die Verknüpfung zwischen einem Standort und seiner Orts-ID auf.
create POST /v4/{parent=accounts/*}/locations
Erstellt eine neue location, die dem angegebenen Konto gehört, und gibt sie zurück.
delete DELETE /v4/{name=accounts/*/locations/*}
Löscht einen Standort.
fetchVerificationOptions POST /v4/{name=accounts/*/locations/*}:fetchVerificationOptions
Meldet alle zulässigen Bestätigungsoptionen für einen Standort in einer bestimmten Sprache.
findMatches POST /v4/{name=accounts/*/locations/*}:findMatches
Ermittelt alle möglichen Standorte, die mit dem angegebenen Standort übereinstimmen.
get GET /v4/{name=accounts/*/locations/*}
Ruft den angegebenen Speicherort ab.
getFoodMenus GET /v4/{name=accounts/*/locations/*/foodMenus}
Gibt die Speisekarten für einen bestimmten Standort zurück.
getGoogleUpdated GET /v4/{name=accounts/*/locations/*}:googleUpdated
Ruft die von Google aktualisierte Version des angegebenen Standorts ab.
getHealthProviderAttributes GET /v4/{name=accounts/*/locations/*/healthProviderAttributes}
Gibt die Attribute des Gesundheitsdienstleisters für einen bestimmten Standort zurück.
getServiceList GET /v4/{name=accounts/*/locations/*/serviceList}
Ruft die angegebene Dienstliste eines Standorts ab.
list GET /v4/{parent=accounts/*}/locations
Listet die Standorte für das angegebene Konto auf.
patch PATCH /v4/{name=accounts/*/locations/*}
Aktualisiert den angegebenen Standort.
reportInsights POST /v4/{name=accounts/*}/locations:reportInsights
Gibt einen Bericht mit Informationen zu einem oder mehreren Messwerten nach Standort zurück.
transfer
(deprecated)
POST /v4/{name=accounts/*/locations/*}:transfer
Verschiebt einen Standort von einem Konto, dessen Inhaber der Nutzer ist, zu einem anderen Konto, das derselbe Nutzer verwaltet.
updateFoodMenus PATCH /v4/{foodMenus.name=accounts/*/locations/*/foodMenus}
Aktualisiert die Speisekarten eines bestimmten Orts.
updateHealthProviderAttributes PATCH /v4/{healthProviderAttributes.name=accounts/*/locations/*/healthProviderAttributes}
Aktualisiert die Attribute des Gesundheitsdienstleisters für einen bestimmten Standort.
updateServiceList PATCH /v4/{serviceList.name=accounts/*/locations/*/serviceList}
Aktualisiert die angegebene Dienstliste eines Standorts
verify POST /v4/{name=accounts/*/locations/*}:verify
Startet den Bestätigungsprozess für einen Standort.

REST-Ressource: v4.accounts.locations.admins

Methoden
create
(deprecated)
POST /v4/{parent=accounts/*/locations/*}/admins
Lädt den angegebenen Nutzer ein, Administrator für den angegebenen Standort zu werden.
delete
(deprecated)
DELETE /v4/{name=accounts/*/locations/*/admins/*}
Entfernt den angegebenen Administrator als Administrator des angegebenen Standorts.
list
(deprecated)
GET /v4/{parent=accounts/*/locations/*}/admins
Listet alle Administratoren für den angegebenen Standort auf.
patch
(deprecated)
PATCH /v4/{name=accounts/*/locations/*/admins/*}
Aktualisiert den Administrator für den angegebenen Standortadministrator.

REST-Ressource: v4.accounts.locations.followers

Methoden
getMetadata GET /v4/{name=accounts/*/locations/*/followers/metadata}
Follower-Einstellungen für einen Standort abrufen.

REST-Ressource: v4.accounts.locations.insuranceNetworks

Methoden
list GET /v4/{parent=accounts/*/locations/*}/insuranceNetworks
Gibt eine Liste aller Versicherungsnetzwerke zurück, die von Google unterstützt werden.

REST-Ressource: v4.accounts.locations.localPosts

Methoden
create POST /v4/{parent=accounts/*/locations/*}/localPosts
Erstellt einen neuen lokalen Beitrag, der mit dem angegebenen Standort verknüpft ist, und gibt ihn zurück.
delete DELETE /v4/{name=accounts/*/locations/*/localPosts/*}
Löscht einen lokalen Beitrag.
get GET /v4/{name=accounts/*/locations/*/localPosts/*}
Ruft den angegebenen lokalen Beitrag ab.
list GET /v4/{parent=accounts/*/locations/*}/localPosts
Gibt eine Liste lokaler Beiträge für einen Standort zurück.
patch PATCH /v4/{name=accounts/*/locations/*/localPosts/*}
Aktualisiert den angegebenen lokalen Beitrag und gibt den aktualisierten lokalen Beitrag zurück
reportInsights POST /v4/{name=accounts/*/locations/*}/localPosts:reportInsights
Gibt Statistiken für eine Reihe von lokalen Beiträgen zurück, die mit einem einzelnen Eintrag verknüpft sind.

REST-Ressource: v4.accounts.locations.media

Methoden
create POST /v4/{parent=accounts/*/locations/*}/media
Erstellt ein neues Medienelement für den Standort.
delete DELETE /v4/{name=accounts/*/locations/*/media/*}
Löscht das angegebene Medienelement.
get GET /v4/{name=accounts/*/locations/*/media/*}
Gibt Metadaten für das angeforderte Medienelement zurück.
list GET /v4/{parent=accounts/*/locations/*}/media
Gibt eine Liste der Medienelemente zurück, die einem Standort zugeordnet sind.
patch PATCH /v4/{name=accounts/*/locations/*/media/*}
Aktualisiert die Metadaten des angegebenen Medienelements.
startUpload POST /v4/{parent=accounts/*/locations/*}/media:startUpload
Generiert eine MediaItemDataRef für das Hochladen von Medienelementen.

REST-Ressource: v4.accounts.locations.media.customers

Methoden
get GET /v4/{name=accounts/*/locations/*/media/customers/*}
Gibt Metadaten für das angeforderte Kundenmedienelement zurück.
list GET /v4/{parent=accounts/*/locations/*}/media/customers
Gibt eine Liste der Medienelemente zurück, die einem Standort zugeordnet sind und von Kunden beigesteuert wurden.

REST-Ressource: v4.accounts.locations.questions

Methoden
create POST /v4/{parent=accounts/*/locations/*}/questions
Fügt eine Frage für den angegebenen Ort hinzu.
delete DELETE /v4/{name=accounts/*/locations/*/questions/*}
Löscht eine bestimmte Frage des aktuellen Nutzers.
list GET /v4/{parent=accounts/*/locations/*}/questions
Gibt eine paginierte Liste mit Fragen und einigen ihrer Antworten für einen bestimmten Ort zurück.
patch PATCH /v4/{name=accounts/*/locations/*/questions/*}
Aktualisiert eine bestimmte Frage des aktuellen Nutzers.

REST-Ressource: v4.accounts.locations.questions.answers

Methoden
delete DELETE /v4/{parent=accounts/*/locations/*/questions/*}/answers:delete
Löscht die Antwort des aktuellen Nutzers auf eine Frage.
list GET /v4/{parent=accounts/*/locations/*/questions/*}/answers
Gibt die paginierte Liste von Antworten auf eine angegebene Frage zurück.
upsert POST /v4/{parent=accounts/*/locations/*/questions/*}/answers:upsert
Erstellt eine Antwort oder aktualisiert die vorhandene Antwort des Nutzers auf die angegebene Frage.

REST-Ressource: v4.accounts.locations.reviews

Methoden
deleteReply DELETE /v4/{name=accounts/*/locations/*/reviews/*}/reply
Löscht die Antwort auf die angegebene Rezension.
get GET /v4/{name=accounts/*/locations/*/reviews/*}
Gibt die angegebene Rezension zurück.
list GET /v4/{parent=accounts/*/locations/*}/reviews
Gibt die paginierte Liste der Rezensionen für den angegebenen Standort zurück.
updateReply PUT /v4/{name=accounts/*/locations/*/reviews/*}/reply
Aktualisiert die Antwort auf die angegebene Rezension.

REST-Ressource: v4.accounts.locations.verifications

Methoden
complete POST /v4/{name=accounts/*/locations/*/verifications/*}:complete
Schließt die Überprüfung PENDING ab.
list GET /v4/{parent=accounts/*/locations/*}/verifications
Listet Bestätigungen eines Standorts nach Erstellungszeit auf.

REST-Ressource: v4.attributes

Methoden
list GET /v4/attributes
Gibt die Liste der verfügbaren Attribute zurück, die für einen Standort mit der angegebenen primären Kategorie und dem angegebenen Land verfügbar wären.

REST-Ressource: v4.categories

Methoden
batchGet GET /v4/categories:batchGet
Gibt eine Liste von Unternehmenskategorien für die angegebene Sprache und GConcept-IDs zurück.
list GET /v4/categories
Gibt eine Liste mit Unternehmenskategorien zurück.

REST-Ressource: v4.chains

Methoden
get GET /v4/{name=chains/*}
Ruft die angegebene Kette ab.
search GET /v4/chains:search
Sucht in der Kette basierend auf dem Kettennamen.

REST-Ressource: v4.googleLocations

Methoden
report POST /v4/{name=googleLocations/*}:report
Eine GoogleLocation melden.
search POST /v4/googleLocations:search
Durchsucht alle möglichen Standorte, die mit der angegebenen Anfrage übereinstimmen.

Dienst: mybusiness.googleapis.com

Um diesen Dienst aufzurufen, empfehlen wir die Verwendung der von Google bereitgestellten Clientbibliotheken. Wenn Ihre Anwendung Ihre eigenen Bibliotheken verwenden muss, um diesen Dienst aufzurufen, verwenden Sie die folgenden Informationen, wenn Sie die API-Anfragen stellen.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente haben. Der Dienst bietet die folgenden Discovery-Dokumente:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://mybusiness.googleapis.com

REST-Ressource: v1.media

Methoden
upload POST /v1/media/{resourceName=**}
POST /upload/v1/media/{resourceName=**}
Lädt Medien hoch.