Skip to main content
Google ReportingVersion: v3

Get reporting data

GET/ad-publishing/google/reporting

Retrieve aggregated Google Ads reporting metrics for a location

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Query Parameters

locationIdstringrequired

Location identifier

Example:fRMewNQIxSyZ5R4nQyit
fieldsstring[]required

Reporting fields. Pass as comma-separated values on the wire (e.g. ?fields=impressions,clicks).

Available optionsimpressionsclickscost_microsaverage_cpcconversionsaverage_cpmcost_per_conversionctr
Example:["impressions","clicks","cost_micros"]
groupBystring

Group by period

Available optionsdateweekmonth
Example:month
startDatestringrequired

Report start date

Example:2022-01-11
endDatestringrequired

Report end date

Example:2022-01-31
typestringrequired

Integration type

Available optionsAD_MANAGERINTEGRATION
Example:INTEGRATION

Response

Metrics grouped by the requested interval, plus totals. Only the requested fields appear.

groupedobject[]required

One entry per time bucket

totalsobjectrequired

Metrics summed across every bucket