Skip to main content
Google AdsVersion: v3

Get entities

GET/ad-publishing/google/entity

Retrieve Google campaigns, ad groups, or ads based on entity type

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:loc_abc123
typestringrequired

Integration type

Available optionsAD_MANAGERINTEGRATION
Example:AD_MANAGER
campaignIdstring

Campaign identifier

Example:196684453527082
adGroupIdstring

Ad group identifier

Example:123456789
entityTypestringrequired

Entity type

Available optionsCAMPAIGNADGROUPAD
Example:CAMPAIGN
searchIdstring

Comma-separated Google Ads IDs to filter by

Example:123,456
startDatestring

Filter start date

Example:2024-01-01
endDatestring

Filter end date

Example:2024-12-31
selectedAdAccountIdstring

Selected ad account ID

Example:123-456-7890

Response

A { data } envelope whose items follow entityType — campaigns, ad groups, or ads

dataobject[]

Campaigns, ad groups, or ads, shaped by the requested entityType