Änderungsprotokoll

v4.9

Neue Funktionen

MoreHours
MoreHours kann jetzt als Teil des Brancheneintrags festgelegt werden.
MoreHourTypes kann für jede Kategorie mithilfe von categories.batchGet abgerufen werden.

Änderungen beim Verhalten

v4.x – Einstellung von Konten
accounts, accounts.admins, accounts.invitations und accounts.locations.admins werden in der Google My Business API nicht mehr unterstützt. Weitere Informationen finden Sie unter Zeitplan für die Einstellung.
CallToAction-Beiträge
Im zweiten Quartal 2021 werden CallToAction-Beiträge mit dem ActionType GET_OFFER ungültig.

v4.8

Neue Funktionen

Ausstattung von Unterkünften
Ausstattung von Unterkünften abrufen und aktualisieren. Weitere Informationen
GetGoogleUpdated-Endpunkt für Unterkünfte hinzufügen.
Booleschen Wert für canOperateLodgingData in LocationState hinzufügen.
Attribute von Anbietern im Gesundheitsbereich
Attribute von Anbietern im Gesundheitsbereich abrufen und aktualisieren. Weitere Informationen
Booleschen Wert für canOperateHealthData in LocationState hinzufügen.
Versicherungsnetzwerke
Versicherungsnetzwerke, die von Standorten akzeptiert werden, auflisten. Weitere Informationen

Änderungen beim Verhalten

Überprüfungs-IDs
Überprüfungs-IDs wurden in ein neues Format migriert. Die neue ID wird jetzt in allen relevanten API-Antworten zurückgegeben. Die bisherigen Überprüfungs-IDs können übergangsweise weiterhin beim Aufrufen der API verwendet werden. Allerdings müssen Sie alle in Ihrem System gespeicherten Überprüfungs-IDs innerhalb von 30 Tagen entsprechend unseren Richtlinien aktualisieren, indem Sie den listReviews-Endpunkt aufrufen.
Unternehmen ohne festen Standort in einem Einzugsgebiet
Ab dem ersten Quartal 2021 wird Address für CUSTOMER_LOCATION_ONLY-Unternehmen nicht mehr im Objekt Location zurückgegeben.

v4.7

Neue Funktionen

Speisekarten
Speisekarten abrufen und aktualisieren. Weitere Informationen

v4.6

Neue Funktionen

Dienstleistungslisten
Sie können die Dienstleistungen, die ein Unternehmen anbietet, jetzt abrufen und aktualisieren. Weitere Informationen
Boolescher Wert für canModifyServiceList in „LocationState“
Gibt an, ob ein Standort Dienstleistungslisten ändern kann. Weitere Informationen
Vordefinierte ServiceTypes für Kategorien
Im Objekt „categories“ sind jetzt vordefinierte Dienstleistungstypen enthalten. Weitere Informationen
CategoryView
Für die Kategorienansicht kann BASIC oder FULL festgelegt werden. In der Ansicht FULL sind zusätzliche Details wie Dienstleistungstypen enthalten. Weitere Informationen
Methode „Categories.BatchGet“
Mit dieser neuen Methode können Sie eine Liste mit Kategorien eingeben, um nur Informationen zu diesen Kategorien abzurufen. Weitere Informationen

v4.5 – Update 2 zu COVID-19

Neue Funktionen

Beitragstyp „COVID-19“
Sie können jetzt COVID_19-Beiträge über die API erstellen. Weitere Informationen

v4.5 – Update 1 zu COVID-19

Neue Funktionen

Vorübergehend geschlossen
Sie können über die API festlegen, dass ein Unternehmen CLOSED_TEMPORARILY ist. Weitere Informationen

v4.5

Neue Funktionen

Pub/Sub für Fragen und Antworten
Sie können jetzt Google Cloud Pub/Sub-Benachrichtigungen für neue/aktualisierte Fragen und Antworten zu einem Standort erhalten. Weitere Informationen
Pub/Sub für Eintragsstatus
Sie können jetzt Google Cloud Pub/Sub-Benachrichtigungen zu Änderungen des Eintragsstatus erhalten. Weitere Informationen

v4.4

Neue Funktionen

Bestätigung lokaler Dienstleistungsunternehmen
Lokale Dienstleistungsunternehmen können jetzt über die API bestätigt werden. Weitere Informationen
Anzahl der Follower
Sie können jetzt Metadaten zu Followern abrufen. Weitere Informationen
Nutzer- und Standortgruppen
Nutzer- und Standortgruppen können jetzt über die API erstellt werden. Weitere Informationen
Neues Feld hasPendingEdits in „LocationState“
Gibt an, ob Änderungen an den Attributen eines Standorts den Status „Ausstehend“ haben. Weitere Informationen

Geändertes Verhalten

Eröffnungsdatum
Für einen Eintrag kann jetzt ein Eröffnungsdatum in der Zukunft festgelegt werden.
PointRadius
PointRadius ist jetzt schreibgeschützt. Wenn Sie lokale Dienstleistungsunternehmen bearbeiten oder erstellen möchten, müssen Sie Places verwenden.

v4.3

Neue Funktionen

APIs für Fragen und Antworten
Fragen abrufen, Antworten posten und häufig gestellte Fragen zu Ihren Standorten zur Verfügung stellen. Weitere Informationen
Bulk-Abruf von Rezensionen
Rezensionen für mehrere Standorte in einem Aufruf abrufen. Weitere Informationen
Empfohlene „GoogleLocations“
Nicht beanspruchte Standorte ansehen, von denen Google annimmt, dass sie Ihnen gehören. Weitere Informationen
Probleme mit „GoogleLocations“ melden
Probleme mit RecommendedGoogleLocations- oder GoogleLocations-Ergebnissen melden. Weitere Informationen
Dienstleistungsoption für PriceList-Abschnitte
Angeben, dass ein PriceList-Bereich entweder Einträge für Essen (FOOD) oder Dienstleistungen (SERVICES) enthält. Weitere Informationen
Beschreibung für Medien
Eine Beschreibung angeben, wenn neue Medien hochgeladen werden. Weitere Informationen
CHAINS_QUERIES-Daten
Abrufen, wie oft ein Standort als Ergebnis angezeigt wurde, wenn nach seiner Kette gesucht wurde. Weitere Informationen

Geändertes Verhalten

Benachrichtigungen für Organisationskonten und Standortgruppen
Konten, für die Pub/Sub-Benachrichtigungen konfiguriert sind, erhalten diese Benachrichtigungen jetzt auch für alle Einträge in einem Organisationskonto oder in Standortgruppen, deren Administrator sie sind.
ListLocations für Organisationskonto und Standortgruppen
Wenn accounts.locations.list mit einem Nutzergruppen- oder Organisationskonto aufgerufen wird, werden jetzt alle Standorte angezeigt, auf die über dieses Konto zugegriffen werden kann.

v4.2

Neue Funktionen

Bestätigungs-APIs
Verfügbare Bestätigungsmethoden für nicht bestätigte Standorte abrufen und auslösen. Weitere Informationen
GoogleLocations API
Auf Google nach vorhandenen Standorten suchen, um Anspruch darauf zu erheben, oder einen Link abrufen, um Zugriff auf beanspruchte Standorte anzufordern. Weitere Informationen
Erweiterte Standortfilter
Zusätzliche Optionen zum Einschränken der Ergebnisse, die von einem Locations.List-Aufruf zurückgegeben werden. Weitere Informationen
Kettenzugehörigkeit
Angeben, dass ein Standort zu einer Kette gehört (z. B. H&M oder Edeka). Weitere Informationen
Informationen zur Organisation
Informationen für Organisationskonten werden jetzt als Teil von „Account“-Objekten angezeigt. Weitere Informationen
Profilbilder von Rezensenten
URLs für Profilbilder von Rezensenten sind jetzt im Objekt „Review“ enthalten. Weitere Informationen

v4.1

Neue Funktionen

Vom Kunden bereitgestellte Medien
Informationen zu von Nutzern erstellten Fotos und Videos für Standorte, deren Inhaber oder Administrator Sie sind, abrufen und ansehen. Weitere Informationen
Admin Management APIs
Einladungen zu Konten und Standorten für Ihr Konto abrufen, akzeptieren und ablehnen. Weitere Informationen
Profile (vom Händler bereitgestellte Beschreibung)
Ihr Unternehmen mit eigenen Worten beschreiben und Nutzern mitteilen, wodurch sich Ihr Unternehmen und Angebot von anderen abhebt. Weitere Informationen
Feld openingDate
Das Datum angeben, an dem Ihr Standort eröffnet wurde. Weitere Informationen
Beiträge zu Angeboten
Eine neue Art von Posts auf Google, mit dem Nutzer auf Angebote aufmerksam gemacht werden können, die an Ihren Standorten verfügbar sind. Weitere Informationen

v4

Neue Funktionen

Posts auf Google
Sie können Posts auf Google jetzt direkt über die API erstellen.
Fotoupload
Neben dem URL-Upload können Fotos jetzt auch direkt über die API hochgeladen werden.
Benachrichtigungen filtern/aktivieren
Sie können jetzt filtern, welche Benachrichtigungen an Pub/Sub-Themen gesendet werden. Zukünftige Benachrichtigungen müssen mithilfe dieses Mechanismus aktiviert werden und werden nicht mehr automatisch an alle Nutzer gesendet.
UPDATED_REVIEW-Benachrichtigungen
Sie können jetzt Benachrichtigungen abonnieren, die bei jeder Änderung an Kundenrezensionen in Echtzeit versendet werden.
Unterstützung für Nutzergruppen
Die Google My Business API unterstützt jetzt Nutzergruppenkonten.

Nicht abwärtskompatible Änderungen

  • „Photos“, das vorher ein Feld von location-Objekten war, ist jetzt eine Ressource unter „Locations“ (accounts/account_ID/locations/location_ID/photos).

  • Das Adressfeld Country ist jetzt region_code und sub_locality ist jetzt sublocality.

  • Das zuvor verworfene Feld Ownership wurde entfernt.

  • Mitinhaber von Konten und Standorten konnten früher nicht über die API von primären Inhabern unterschieden werden (alle wurden als OWNER angezeigt). Jetzt wird primären Inhabern die Rolle OWNER und anderen Inhabern die Rolle CO_OWNER zugewiesen.

  • AccountType.BUSINESS heißt jetzt AccountType.LOCATION_GROUP.

  • Wenn Sie eine Feldmaske zum Aktualisieren von Standorten verwenden, geben Sie update_mask anstelle der vorhandenen field_mask an.

  • Die Nachricht, die für primary_category und additional_categories verwendet wird, enthält kein visuell lesbares Format mehr. Nutzer sollten den Kategoriedienst der Google My Business API verwenden, um übersetzte, visuell lesbare Kategorienamen zu erhalten.

v3.3

Neue Funktionen

Strukturierte Menüs

Sie können jetzt:

  • mehrere Menüs für einen bestimmten Standort hinzufügen, aktualisieren oder löschen.

  • Menüs in mehrere Abschnitte unterteilen.

  • Menüpunkte mit Name, Beschreibung, Preis und Fotos aufführen.

v3.2

Neue Funktionen

Daten
Sie können über die API jetzt Standortdaten abrufen und Messwerte für Routen generieren.
Benachrichtigungen
Sie können jetzt Benachrichtigungen abonnieren, die Sie in Echtzeit über neue Google-Updates informieren.

Nicht abwärtskompatible Änderungen

  • Die nicht verwendeten Felder languageCodes und platforms von UrlAttributeValue wurden entfernt.

  • SAME in der verworfenen Option „Ownership“ wird nur noch angewendet, wenn der duplizierte Standort denselben primären Inhaber hat. Zuvor beruhte das Verhalten auf einer komplexeren Berechnung der Inhaberschaft.

v3.1

Neue Funktionen

Benachrichtigungen
Sie können sich jetzt in Echtzeit über neue Rezensionen benachrichtigen lassen.
Maps-URLs
Google Maps-URLs sind in Standortantworten enthalten. Nutzer können so ganz einfach Verknüpfungen zu Maps erstellen.
Standortstatus
Zusätzliche Standortstatus, die angeben, wann der Eintrag veröffentlicht oder deaktiviert wurde bzw. ob seine Bestätigung aussteht.
Flag für Neueröffnung
Das Flag canReopen wird für dauerhaft geschlossene Standorte verwendet, die wiedereröffnet werden können (im Gegensatz zu Standorten, bei denen das nicht möglich ist).
Attribute
Unterstützung von URL- und „Enum“-Attributen.
Kategorie-Endpunkt
Liste der unterstützten Kategorien nach Land und Sprache abrufen (ersetzt CSV-Dateien).

v3

Neue Funktionen

Rezensionen
Über die API Rezensionen zu Unternehmen abrufen und darauf antworten.
Attribute
Zusätzliche, kategoriespezifische Informationen zu Standorten angeben.
Passenden Standort suchen
Bestehende Standorte in Maps suchen und manuell mit Ihrem Unternehmensstandort verknüpfen.
Standort übertragen
Neue Aktion für Location :transfer. Damit kann ein Standort von einem (Unternehmens- oder privaten) Konto auf ein anderes übertragen werden.
Bevorzugtes Bild
Festlegen, welches Foto als erstes in Google Maps und in der Google Suche angezeigt werden soll.
Neue Suchfilter
Zu den neuen Suchfiltern gehören any_google_updates, is_suspended und is_duplicate.
Neue Standortstatus
Zu den Standortstatus gehören jetzt auch is_verified und needs_reverification.
Foto-URLs – Optimierungen
In der API sind jetzt auch Foto-URLs ohne Suffix für das Bildformat zulässig.

Nicht abwärtskompatible Änderungen

  • Fotos für Standorte mit einer Google+ Seite können nur noch aktualisiert werden (zuvor wurden sie zuerst akzeptiert und dann ohne Benachrichtigung entfernt).

  • location_name und category_name sind nur noch Ausgabefelder. Daher müssen Kategorie-IDs verwendet werden, um Kategorien festzulegen.

  • Feldmasken dürfen nicht mehr das Präfix location. für eingeschlossene Felder enthalten.

  • Bei „Create“- und „Update“-Vorgängen wird jetzt der Standort als Nutzlast für den Anfragetext verwendet. Andere Parameter werden in den Abfragestring verschoben.

v2

Nicht abwärtskompatible Änderungen

  • In CreateLocation-Aufrufen muss jetzt eine request_id angegeben werden. Sie muss für jeden Standort eindeutig sein. So lässt sich vermeiden, dass doppelte Standorte in Ihrem Konto erstellt werden. Wenn Sie versuchen, einen Standort zu erstellen, bei dem die Anfrage-ID mit einem zuvor erstellten Standort übereinstimmt, wird nur der vorhandene Standort zurückgegeben. Es wird kein Duplikat in Ihrem Konto erstellt.

    • In Location wurde business_hours in regular_hours umbenannt.