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. readonlyAuth methods:
OAuthPrivate IntegrationToken type:
Sub-Account TokenRequest
Headers
Versionstringrequired
API Version
Available options
v3Example:
v3Query Parameters
locationIdstringrequired
Location identifier
Example:
fRMewNQIxSyZ5R4nQyitfieldsstring[]required
Reporting fields. Pass as comma-separated values on the wire (e.g. ?fields=impressions,clicks).
Available options
impressionsclickscost_microsaverage_cpcconversionsaverage_cpmcost_per_conversionctrExample:
["impressions","clicks","cost_micros"]groupBystring
Group by period
Available options
dateweekmonthExample:
monthstartDatestringrequired
Report start date
Example:
2022-01-11endDatestringrequired
Report end date
Example:
2022-01-31typestringrequired
Integration type
Available options
AD_MANAGERINTEGRATIONExample:
INTEGRATIONResponse
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