Business Information API

Änderungsprotokoll

v1

API-Zugriff

Die Business Information API muss über die GCP Console aktiviert werden. Der OAuth-Bereich bleibt gleich.

Endpunkt-URL

Endpunkte für alle Informationen zum Unternehmen, Attribute, Kategorien, Ketten und Standortsuchen sind unter https://mybusinessbusinessinformation.googleapis.com/v1/ und nicht https://mybusiness.googleapis.com/v4/ verfügbar.

Der Pfadname für Standortendpunkte wurde von accounts/accountId/locations/locationId zu locations/locationId geändert.

Standortaktualisierungen

  • locationName wurde in title umbenannt.
  • websiteUrl wurde in websiteUri umbenannt.
  • accounts.locations.list und locations.get benötigen jetzt einen „readMask“-Parameter.
  • primaryPhone und additionalPhones sind jetzt Teil von PhoneNumbers.
  • primaryCategory und additionalCategories sind jetzt Teil von Categories.
  • address wurde in storefrontAddress umbenannt.
  • accounts.locations.clearAssociation wurde zu locations.clearLocationAssociation geändert.
  • serviceItems werden jetzt direkt aus dem Location-Objekt gelesen und aktualisiert.

Attribute

  • Es gibt ein neues Attributes-Objekt und einen entsprechenden Endpunkt locations.attributes.getGoogleUpdated zum Abrufen der aktualisierten Version von Google.
  • Für attributes.list gibt es einen show_all-Parameter, mit dem Kunden alle Attribute aufrufen können, die sich für eine bestimmte Kombination aus Kategorie und Region festlegen lassen.

Unternehmen ohne festen Standort in einem Einzugsgebiet

  • Unternehmen vom Typ CUSTOMER_LOCATION_ONLY müssen keine Adresse mehr eingeben.
  • Der regionCode wurde in ServiceAreaBusiness eingefügt. Er muss für Unternehmen des Typs CUSTOMER_LOCATION_ONLY festgelegt werden.

Verworfene Endpunkte und Objekte

  • Das Objekt LocationKey wurde entfernt. Die vorhandenen Felder wurden in Metadata verschoben.
  • Das Objekt PriceLists wurde entfernt. Es wurde durch „FoodMenus“ und „ServiceLists“ ersetzt.
  • Das Objekt LocationState wurde entfernt. Die meisten vorhandenen Felder wurden in Metadata verschoben. Obwohl „Metadata“ einen booleschen Wert enthält, um festzustellen, ob der Händler die volle Kontrolle über das Unternehmen hat (Zustimmung des Händlers), wurden detailliertere Felder mit Bezug zu Sperrungen und Bestätigungen in die Verifications API verschoben. Verwenden Sie die Methode locations.getVoiceOfMerchantState, um zu ermitteln, ob weitere Schritte erforderlich sind, um die Zustimmung des Händlers zu erhalten.
  • Die Endpunkte googleLocations.report und accounts.locations.findMatchingLocations wurden verworfen.
  • Der Endpunkt TransferLocation wurde zu locations.transfer der Account Management API verschoben.