Attention: There will be major changes to the API soon that will require migration work. Please check our upcoming releases page and deprecation schedule frequently for updates. You may also sign up for our mailing list to receive updates.

Business Information API

Change log

v1

API Access

The Business Information API will need to be enabled from the GCP Console. The OAuth scope remains the same.

Endpoint URL

Endpoints for all business information, attributes, categories, chains and locations search are accessible at https://mybusinessbusinessinformation.googleapis.com/v1/ instead of https://mybusiness.googleapis.com/v4/

The path name for locations endpoints has changed from accounts/accountId/locations/locationId to locations/locationId

Location Updates

  • locationName has been renamed to title.
  • websiteUrl has been renamed to websiteUri.
  • accounts.locations.list and locations.get now requires a readMask.
  • primaryPhone and additionalPhones are now part of PhoneNumbers.
  • primaryCategory and additionalCategories are now part of Categories.
  • address has been renamed to storefrontAddress.
  • accounts.locations.clearAssociation has been updated to locations.clearLocationAssociation.

Attributes

  • New Attributes object and corresponding locations.attributes.getGoogleUpdated endpoint to get the Google updated version.
  • attributes.list has a show_all parameter allowing clients to see all the various attributes that can be set for a particular category and region combination.

Service Area Businesses

  • Businesses of type CUSTOMER_LOCATION_ONLY are no longer required to fill out an address.
  • Addition of regionCode in ServiceAreaBusiness. It must be set for businesses of type CUSTOMER_LOCATION_ONLY.

Deprecated Endpoints and Objects

  • Removal of LocationKey object. The existing fields have been moved into Metadata.
  • Removal of PriceLists object. It has been replaced by FoodMenus and ServiceLists.
  • Removal of LocationState object. The existing fields have been moved into Metadata.
  • The endpoints googleLocations.report and accounts.locations.findMatchingLocations have been deprecated.
  • TransferLocation endpoint has been moved to locations.transfer under the Account Management API.