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.
My Business Business Calls API
Stay organized with collections
Save and categorize content based on your preferences.
The My Business Business Calls API manages business calls information of a location on Google and collect insights like the number of missed calls to their location. Additional information about Business calls can be found at https://support.google.com/business/answer/9688285?p=call_history.
If the Google Business Profile links to a Google Ads account and call history is turned on, calls that last longer than a specific time, and that can be attributed to an ad interaction, will show in the linked Google Ads account under the "Calls from Ads" conversion. If smart bidding and call conversions are used in the optimization strategy, there could be a change in ad spend. Learn more about smart bidding.
To view and perform actions on a location's calls, you need to be a OWNER, CO_OWNER or MANAGER of the location.
Service: mybusinessbusinesscalls.googleapis.com
To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.
Discovery document
A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:
Service endpoint
A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:
https://mybusinessbusinesscalls.googleapis.com
| Methods |
getBusinesscallssettings |
GET /v1/{name=locations/*/businesscallssettings}
Returns the Business calls settings resource for the given location. |
updateBusinesscallssettings |
PATCH /v1/{businessCallsSettings.name=locations/*/businesscallssettings}
Updates the Business call settings for the specified location. |
| Methods |
list |
GET /v1/{parent=locations/*}/businesscallsinsights
Returns insights for Business calls for a location. |
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 2024-10-16 UTC.
[null,null,["Last updated 2024-10-16 UTC."],[[["\u003cp\u003eThe My Business Business Calls API allows you to manage and analyze business call data for Google Business Profile locations, including insights like missed calls.\u003c/p\u003e\n"],["\u003cp\u003eWhen linked with Google Ads and call history enabled, eligible calls may appear as conversions, potentially impacting ad spending with smart bidding.\u003c/p\u003e\n"],["\u003cp\u003eYou need specific roles (\u003ccode\u003eOWNER\u003c/code\u003e, \u003ccode\u003eCO_OWNER\u003c/code\u003e, or \u003ccode\u003eMANAGER\u003c/code\u003e) to access and manage a location's call data.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides resources to retrieve Business Calls settings and insights, and is accessible through Google-provided client libraries or REST endpoints.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize the provided discovery document and service endpoint for integration and interaction with the API.\u003c/p\u003e\n"]]],["The My Business Business Calls API enables management of business call data for Google locations, including insights like missed calls. Users with `OWNER`, `CO_OWNER`, or `MANAGER` roles can access and modify call settings and retrieve business call insights using `GET` and `PATCH` methods on resources. If call history is enabled and the location is linked to Google Ads, calls longer than a set duration that came from an ad can be tracked in Google Ads and could influence ad spending.\n"],null,["# My Business Business Calls API\n\nThe My Business Business Calls API manages business calls information of a location on Google and collect insights like the number of missed calls to their location. Additional information about Business calls can be found at \u003chttps://support.google.com/business/answer/9688285?p=call_history.\u003e \n\nIf the Google Business Profile links to a Google Ads account and call history is turned on, calls that last longer than a specific time, and that can be attributed to an ad interaction, will show in the linked Google Ads account under the \"Calls from Ads\" conversion. If smart bidding and call conversions are used in the optimization strategy, there could be a change in ad spend. [Learn more about smart bidding](https://support.google.com/google-ads/answer/7065882). \n\nTo view and perform actions on a location's calls, you need to be a `OWNER`, `CO_OWNER` or `MANAGER` of the location.\n\n- [REST Resource: v1.locations](#v1.locations)\n- [REST Resource: v1.locations.businesscallsinsights](#v1.locations.businesscallsinsights)\n\nService: mybusinessbusinesscalls.googleapis.com\n-----------------------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://mybusinessbusinesscalls.googleapis.com/$discovery/rest?version=v1\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://mybusinessbusinesscalls.googleapis.com`\n\nREST Resource: [v1.locations](/my-business/reference/businesscalls/rest/v1/locations)\n-------------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| [getBusinesscallssettings](/my-business/reference/businesscalls/rest/v1/locations/getBusinesscallssettings) | `GET /v1/{name=locations/*/businesscallssettings}` Returns the Business calls settings resource for the given location. |\n| [updateBusinesscallssettings](/my-business/reference/businesscalls/rest/v1/locations/updateBusinesscallssettings) | `PATCH /v1/{businessCallsSettings.name=locations/*/businesscallssettings}` Updates the Business call settings for the specified location. |\n\nREST Resource: [v1.locations.businesscallsinsights](/my-business/reference/businesscalls/rest/v1/locations.businesscallsinsights)\n---------------------------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|\n| [list](/my-business/reference/businesscalls/rest/v1/locations.businesscallsinsights/list) | `GET /v1/{parent=locations/*}/businesscallsinsights` Returns insights for Business calls for a location. |"]]