What do I need to know?
Over the course of 2021, we launched a new set of APIs to help you manage your Business Profile. Our new set of APIs provide you greater API consumption flexibility, and help us to release new product updates faster. In addition to the new APIs launched, we also have launched the new Business Profile Performance API. Please check below for the current list and past list of deprecated resources and their replacements if applicable.What do I need to do?
Business Profile Performance API
Update to the new Business Profile Performance API to continue getting insights on your business profile.
Please explore the new locations.fetchMultiDailyMetricsTimeSeries API method that allows fetching of multiple DailyMetrics
objects with a single API request. Note that v4 locations.reportInsights and its associated API resources
have been deprecated on March 30, 2023.
In addition, please note that My Business Business calls API will be deprecated on May 30, 2023. If you are using the My Business Business calls API, please follow the below steps:
- Use
UpdateBusinessCallsSettingsto disable call history for business locations that were enabled using the API. Once the API is deprecated on May 30, 2023, you will only be able to disable call history using the Google Business Profile UI in Google Maps or Google search. - Discontinue using the My Business Business calls API method to avoid disruption.
We will also be deprecating locations.associate and locations.clearLocationAssociation API methods which are part of
My Business Business Information API on May 30, 2023.
API versions
- Support Ended indicates that the version of the API will continue to function as expected, but may not be updated with new features or bug fixes. Support will be limited.
- Discontinuation indicates that the version of the API will always return errors and will soon be shut down.
Current Deprecation Schedule
| Deprecated Resource | Type | Replacement Resource | Support Ended | Discontinuation Date |
|---|---|---|---|---|
| My Business Calls API deprecation | ||||
| My Business Business Calls API | API | None | 2023-02-21 | 2023-05-30 |
| locations.associate and locations.clearLocationAssociation deprecation | ||||
| locations.associate (My Business Business Information API v1) | Method | None | 2023-02-21 | 2023-05-30 |
| locations.clearLocationAssociation (My Business Business Information API v1) | Method | None | 2023-02-21 | 2023-05-30 |
| Business Profile Performance API Migration | ||||
| accounts.locations.reportInsights (Google My Business v4.9) | Method | locations.fetchMultiDailyMetricsTimeSeries (Google Business Profile Performance API v1) | 2022-11-21 | 2023-03-30 |
| accounts.locations.localPosts.reportInsights (Google My Business v4.9) | Method | None | 2022-11-21 | 2023-02-20 |
| DrivingDirectionMetricsRequest and LocationDrivingDirectionMetrics (accounts.locations.reportInsights v4.9 Object) | Object | None | 2022-11-21 | 2023-03-30 |
| ALL (accounts.locations.reportInsights v4.9 Metric) | Metric | None | 2022-11-21 | 2023-03-30 |
| QUERIES_DIRECT (accounts.locations.reportInsights v4.9 Metric) | Metric | None | 2022-11-21 | 2023-03-30 |
| QUERIES_INDIRECT (accounts.locations.reportInsights v4.9 Metric) | Metric | None | 2022-11-21 | 2023-03-30 |
| QUERIES_CHAIN (accounts.locations.reportInsights v4.9 Metric) | Metric | None | 2022-11-21 | 2023-03-30 |
| VIEWS_MAPS (accounts.locations.reportInsights v4.9 Metric) | Metric | BUSINESS_IMPRESSIONS_DESKTOP_MAPS and
BUSINESS_IMPRESSIONS_MOBILE_MAPS (Google Business Profile Performance API v1) |
2022-11-21 | 2023-03-30 |
| VIEWS_SEARCH
(accounts.locations.reportInsights v4.9 Metric) |
Metric | BUSINESS_IMPRESSIONS_DESKTOP_SEARCH and
BUSINESS_IMPRESSIONS_MOBILE_SEARCH (Google Business Profile Performance API v1) |
2022-11-21 | 2023-03-30 |
| ACTIONS_WEBSITE
(accounts.locations.reportInsights v4.9 Metric) |
Metric | WEBSITE_CLICKS
(Google Business Profile Performance API v1) |
2022-11-21 | 2023-03-30 |
| ACTIONS_PHONE
(accounts.locations.reportInsights v4.9 Metric) |
Metric | CALL_CLICKS
(Google Business Profile Performance API v1) |
2022-11-21 | 2023-03-30 |
| ACTIONS_DRIVING_DIRECTIONS
(accounts.locations.reportInsights v4.9 Metric) |
Metric | BUSINESS_DIRECTION_REQUESTS
(Google Business Profile Performance API v1) |
2022-11-21 | 2023-03-30 |
| PHOTOS_VIEWS_MERCHANT (accounts.locations.reportInsights v4.9 Metric) | Metric | None | 2022-11-21 | 2023-02-20 |
| PHOTOS_VIEWS_CUSTOMERS (accounts.locations.reportInsights v4.9 Metric) | Metric | None | 2022-11-21 | 2023-02-20 |
| PHOTOS_COUNT_MERCHANT (accounts.locations.reportInsights v4.9 Metric) | Metric | None | 2022-11-21 | 2023-02-20 |
| PHOTOS_COUNT_CUSTOMERS (accounts.locations.reportInsights v4.9 Metric) | Metric | None | 2022-11-21 | 2023-02-20 |
| LOCAL_POST_VIEWS_SEARCH (accounts.locations.reportInsights v4.9 Metric) | Metric | None | 2022-11-21 | 2023-02-20 |
| LOCAL_POST_ACTIONS_CALL_TO_ACTION (accounts.locations.reportInsights v4.9 Metric) | Metric | None | 2022-11-21 | 2023-02-20 |
| MediaInsights (accounts.locations.media v4.9 Object) | Object | None | 2022-11-21 | 2023-02-20 |
Past Deprecation Schedule
The table below lists the v4 API resources that were deprecated in the past and their respective replacements. We encourage you to migrate to the newest version, if you have not already. As of June 30, 2022, the below list of v4 API methods will return "404 Not Found" error.| Deprecated Resource | Replacement Resource | Support Ended | Discontinuation Date |
|---|---|---|---|
| accounts.locations.questions [Google My Business API v4.9] |
locations.questions [Questions API v1] |
2021-11-18 | 2022-04-30 |
| accounts.locations.questions.answers [Google My Business API v4.9] |
locations.questions.answers [Answers API v1] |
2021-11-18 | 2022-04-30 |
| accounts [Google My Business API v4.9] |
accounts [Account Management API v1] accounts [Notifications API v1] |
2021-02-22 | 2022-04-30 |
| accounts.admins [Google My Business API v4.9] | accounts.admins [Account Management API v1] | 2021-02-22 | 2022-04-30 |
| accounts.invitations [Google My Business API v4.9] | accounts.invitations [Account Management API v1] | 2021-02-22 | 2022-04-30 |
| accounts.locations.admins [Google My Business API v4.9] | locations.admins [Account Management API v1] | 2021-02-22 | 2022-04-30 |
| accounts.locations [Google My Business API v4.9] | accounts.locations [Business Information API v1] locations [Business Information API v1] locations [Verifications API v1] | 2021-08-24 | 2022-04-30 |
| attributes [Google My Business API v4.9] | attributes [Business Information API v1] | 2021-08-24 | 2022-04-30 |
| categories [Google My Business API v4.9] | categories [Business Information API v1] | 2021-08-24 | 2022-04-30 |
| chains [Google My Business API v4.9] | chains [Business Information API v1] | 2021-08-24 | 2022-04-30 |
| googleLocations [Google My Business API v4.9] | googleLocations [Business Information API v1] | 2021-08-24 | 2022-04-30 |
| attributes [Google My Business API v4.9] | locations.attributes [Business Information API v1] | 2021-08-24 | 2022-04-30 |
| accounts.locations.verifications [Google My Business API v4.9] | locations.verifications [Verifications API v1] | 2021-08-24 | 2022-04-30 |
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 2023-04-04 UTC.