Google Business Performance
API has a NEW
API method that allows fetching multiple `DailyMetrics` in a single API request. Review the deprecation schedule
and instructions to migrate over from v4 reportInsights API method to Google Business Profile Performance API.
Business Information API
Stay organized with collections
Save and categorize content based on your preferences.
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
.
-
serviceItems
are now read and updated directly from the Location object.
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. Most of the existing fields have been moved into Metadata
. Although Metadata contains a boolean to see whether the merchant has full control of the business (voice of merchant), more detailed suspension and verification related fields have been moved to the Verifications API
. Use method locations.getVoiceOfMerchantState
for next steps in order to gain voice of merchant.
- The endpoints
googleLocations.report
and accounts.locations.findMatchingLocations
have been deprecated.
-
TransferLocation
endpoint has been moved to locations.transfer
under the
Account Management API.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThe Business Information API now uses \u003ccode\u003ehttps://mybusinessbusinessinformation.googleapis.com/v1/\u003c/code\u003e as the base endpoint and requires enabling in the GCP Console.\u003c/p\u003e\n"],["\u003cp\u003eLocation data structure has been updated, renaming or relocating fields like \u003ccode\u003elocationName\u003c/code\u003e, \u003ccode\u003ewebsiteUrl\u003c/code\u003e, \u003ccode\u003eprimaryPhone\u003c/code\u003e, \u003ccode\u003eprimaryCategory\u003c/code\u003e, and \u003ccode\u003eaddress\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eA new \u003ccode\u003eAttributes\u003c/code\u003e object and \u003ccode\u003egetGoogleUpdated\u003c/code\u003e endpoint have been introduced for managing business attributes, and \u003ccode\u003eattributes.list\u003c/code\u003e now includes a \u003ccode\u003eshow_all\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eService area businesses (\u003ccode\u003eCUSTOMER_LOCATION_ONLY\u003c/code\u003e) no longer require an address but need a \u003ccode\u003eregionCode\u003c/code\u003e, while \u003ccode\u003eLocationKey\u003c/code\u003e, \u003ccode\u003ePriceLists\u003c/code\u003e, and \u003ccode\u003eLocationState\u003c/code\u003e objects are deprecated.\u003c/p\u003e\n"],["\u003cp\u003eSome endpoints have been moved or deprecated, including \u003ccode\u003egoogleLocations.report\u003c/code\u003e, \u003ccode\u003eaccounts.locations.findMatchingLocations\u003c/code\u003e, and \u003ccode\u003eTransferLocation\u003c/code\u003e.\u003c/p\u003e\n"]]],["The Business Information API requires enabling in the GCP Console, with a new endpoint URL: `https://mybusinessbusinessinformation.googleapis.com/v1/`. Location endpoints' path changed to `locations/locationId`. Updates include renaming fields like `locationName` to `title` and incorporating `PhoneNumbers` and `Categories`. `Attributes` now includes a `getGoogleUpdated` endpoint, with `show_all` parameter. Service area businesses (type `CUSTOMER_LOCATION_ONLY`) now require `regionCode`. Deprecated objects include `LocationKey`, `PriceLists`, `LocationState`, and removed endpoints `googleLocations.report`, `accounts.locations.findMatchingLocations`, and `TransferLocation` moved.\n"],null,["# Business Information API\n\n\u003cbr /\u003e\n\nChange log\n----------\n\n### v1\n\n#### API Access\n\nThe Business Information API will need to be enabled from the [GCP Console](https://console.developers.google.com/apis/library/mybusinessbusinessinformation.googleapis.com). The OAuth scope remains the same.\n\n#### Endpoint URL\n\nEndpoints 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/`\n\nThe path name for locations endpoints has changed from `accounts/accountId/locations/locationId` to `locations/locationId`\n\n#### Location Updates\n\n- `locationName` has been renamed to `title`.\n- `websiteUrl` has been renamed to `websiteUri`.\n- `accounts.locations.list` and `locations.get` now requires a readMask.\n- `primaryPhone` and `additionalPhones` are now part of [PhoneNumbers](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.PhoneNumbers).\n- `primaryCategory` and `additionalCategories` are now part of [Categories](/my-business/reference/businessinformation/rest/v1/accounts.locations#categories).\n- `address` has been renamed to `storefrontAddress`.\n- `accounts.locations.clearAssociation` has been updated to `locations.clearLocationAssociation`.\n- `serviceItems` are now read and updated directly from the Location object.\n\n#### Attributes\n\n- New `Attributes` object and corresponding [locations.attributes.getGoogleUpdated](/my-business/reference/businessinformation/rest/v1/locations.attributes/getGoogleUpdated) endpoint to get the Google updated version.\n- `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.\n\n#### Service Area Businesses\n\n- Businesses of type `CUSTOMER_LOCATION_ONLY` are no longer required to fill out an address.\n- Addition of `regionCode` in [ServiceAreaBusiness](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.ServiceAreaBusiness). It must be set for businesses of type `CUSTOMER_LOCATION_ONLY`.\n\n#### Deprecated Endpoints and Objects\n\n- Removal of `LocationKey` object. The existing fields have been moved into [Metadata](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.Metadata).\n- Removal of `PriceLists` object. It has been replaced by FoodMenus and ServiceLists.\n- Removal of `LocationState` object. Most of the existing fields have been moved into [Metadata](/my-business/reference/businessinformation/rest/v1/accounts.locations#Location.Metadata). Although Metadata contains a boolean to see whether the merchant has full control of the business (voice of merchant), more detailed suspension and verification related fields have been moved to the [Verifications API](/my-business/reference/verifications/rest). Use method [locations.getVoiceOfMerchantState](/my-business/reference/verifications/rest/v1/locations/getVoiceOfMerchantState) for next steps in order to gain voice of merchant.\n- The endpoints `googleLocations.report` and `accounts.locations.findMatchingLocations` have been deprecated.\n- `TransferLocation` endpoint has been moved to `locations.transfer` under the Account Management API."]]
