Skip to main content
Google ReportingVersion: v3New

Get reporting list

GET/ad-publishing/google/reporting/list
deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Retrieve a list of Google campaigns or ad groups with reporting data. Deprecated: use GET /ad-publishing/google/reporting/rows with header version: v4.

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
listTypestringrequired

Report list type

Available optionscampaignsadsadGroupskeywords
Example:campaigns
startDatestringrequired

Report start date

Example:2022-01-11
endDatestringrequired

Report end date

Example:2022-01-31
campaignIdstring

Campaign identifier (required when listType is adGroups, ads, or keywords)

Example:196684453527082
typestringrequired

Integration type

Available optionsAD_MANAGERINTEGRATION
Example:INTEGRATION

Response

application/json

One entry per entity, shaped by listType. campaigns keeps Google's nested { campaign, metrics } row and only adds the attributed revenue block when type=AD_MANAGER; adGroups and ads flatten the entity onto the row and always carry revenue; keywords flattens name and id from the criterion and carries no revenue at all.

  • Array items
    • oneOf
    campaignobjectrequired

    Campaign fields, nested as Google returns them rather than flattened onto the row

    metricsobjectrequired

    Google Ads metrics for the period

    revenuestring

    Attributed revenue. Present only for type=AD_MANAGER.

    Example:0.00
    salesstring

    Attributed sales count. type=AD_MANAGER only.

    Example:0
    leadsstring

    Attributed leads count. type=AD_MANAGER only.

    Example:0
    averageRevenuestring

    Average revenue per sale. type=AD_MANAGER only.

    Example:0.00