Method: accounts.locations.reportInsights

  • This endpoint POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:reportInsights returns insights on metrics by location for a Google My Business account, limited to 10 locations per call.

  • You can request insights on basic metrics and/or driving direction requests, specifying the number of days (7, 30, or 90) for data aggregation.

  • The response includes metric values by location, as well as driving direction metrics showing top regions people come from when requesting directions.

  • Authorization is required using either the https://www.googleapis.com/auth/plus.business.manage or https://www.googleapis.com/auth/business.manage scope.

  • Reports provide insights such as the total number of searches, views, actions, and driving direction requests for specified locations and time periods.

Returns a report containing insights on one or more metrics by location.

HTTP request

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:reportInsights

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

The account resource name.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "locationNames": [
    string
  ],
  "basicRequest": {
    object (BasicMetricsRequest)
  },
  "drivingDirectionsRequest": {
    object (DrivingDirectionMetricsRequest)
  }
}
Fields
locationNames[]

string

A collection of locations to fetch insights for, specified by their names.
basicRequest

object (BasicMetricsRequest)

A request to include basic metric insights in the report.
drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

A request to include insights about driving-direction requests in the report.

Response body

If successful, the response body contains data with the following structure:

Response message for Insights.ReportLocationInsights.

JSON representation 
{
  "locationMetrics": [
    {
      object (LocationMetrics)
    }
  ],
  "locationDrivingDirectionMetrics": [
    {
      object (LocationDrivingDirectionMetrics)
    }
  ]
}
Fields
locationMetrics[]

object (LocationMetrics)

A collection of metric values by location.
locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

A collection of values for driving direction-related metrics.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

For more information, see the OAuth 2.0 Overview.

DrivingDirectionMetricsRequest

A request for driving direction insights.

JSON representation 
{
  "numDays": enum (NumDays),
  "languageCode": string
}
Fields
numDays

enum (NumDays)

The number of days to aggregate data for. Results returned will be available data over the last number of requested days. Valid values are 7, 30, and 90.
languageCode

string

The BCP 47 code for the language. If a language code is not provided, it defaults to English.

NumDays

Number of days that this request can support.

Enums
SEVEN 7 days. This is the default value.
THIRTY 30 days.
NINETY 90 days.

LocationMetrics

A series of Metrics and BreakdownMetrics associated with a Location over some time range.

JSON representation 
{
  "locationName": string,
  "timeZone": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Fields
locationName

string

The location resource name these values belong to.
timeZone

string

IANA timezone for the location.
metricValues[]

object (MetricValue)

A list of values for the requested metrics.

LocationDrivingDirectionMetrics

A location indexed with the regions that people usually come from. This is captured by counting how many driving-direction requests to this location are from each region.

JSON representation 
{
  "locationName": string,
  "topDirectionSources": [
    {
      object (TopDirectionSources)
    }
  ],
  "timeZone": string
}
Fields
locationName

string

The location resource name this metric value belongs to.
topDirectionSources[]

object (TopDirectionSources)

Driving-direction requests by source region. By convention, these are sorted by count with at most 10 results.
timeZone

string

Time zone (IANA timezone IDs, for example, 'Europe/London') of the location.

TopDirectionSources

Top regions where driving-direction requests originated from.

JSON representation 
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
Fields
dayCount

integer

The number of days data is aggregated over.
regionCounts[]

object (RegionCount)

Regions sorted in descending order by count.

RegionCount

A region with its associated request count.

JSON representation 
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
Fields
latlng

object (LatLng)

Center of region.
label

string

Human-readable label for the region.
count

string (int64 format)

Number of driving-direction requests from this region.