Skip to main content

campaigns

Overview

Namecampaigns
TypeResource
Idgoogleads.dfareporting.campaigns

Fields

NameDatatypeDescription
idstringID of this campaign. This is a read-only auto-generated field.
namestringName of this campaign. This is a required field and must be less than 512 characters long and unique among campaigns of the same advertiser.
advertiserGroupIdstringAdvertiser group ID of the associated advertiser.
archivedbooleanWhether this campaign has been archived.
commentstringArbitrary comments about this campaign. Must be less than 256 characters long.
clickThroughUrlSuffixPropertiesobjectClick Through URL Suffix settings.
advertiserIdstringAdvertiser ID of this campaign. This is a required field.
kindstringIdentifies what kind of resource this is. Value: the fixed string "dfareporting#campaign".
defaultClickThroughEventTagPropertiesobjectProperties of inheriting and overriding the default click-through event tag. A campaign may override the event tag defined at the advertiser level, and an ad may also override the campaign's setting further.
defaultLandingPageIdstringThe default landing page ID for this campaign.
createInfoobjectModification timestamp.
externalIdstringExternal ID for this campaign.
advertiserIdDimensionValueobjectRepresents a DimensionValue resource.
creativeGroupIdsarrayList of creative group IDs that are assigned to the campaign.
accountIdstringAccount ID of this campaign. This is a read-only field that can be left blank.
adBlockingConfigurationobjectCampaign ad blocking settings.
creativeOptimizationConfigurationobjectCreative optimization settings.
startDatestring
audienceSegmentGroupsarrayAudience segment groups assigned to this campaign. Cannot have more than 300 segment groups.
additionalCreativeOptimizationConfigurationsarrayAdditional creative optimization configurations for the campaign.
subaccountIdstringSubaccount ID of this campaign. This is a read-only field that can be left blank.
measurementPartnerLinkobject
eventTagOverridesarrayOverrides that can be used to activate or deactivate advertiser event tags.
lastModifiedInfoobjectModification timestamp.
idDimensionValueobjectRepresents a DimensionValue resource.
billingInvoiceCodestringBilling invoice code included in the Campaign Manager client billing invoices associated with the campaign.
endDatestring

Methods

NameAccessible byRequired ParamsDescription
getSELECTid, profileIdGets one campaign by ID.
listSELECTprofileIdRetrieves a list of campaigns, possibly filtered. This method supports paging.
insertINSERTprofileIdInserts a new campaign.
patchEXECid, profileIdUpdates an existing campaign. This method supports patch semantics.
updateEXECprofileIdUpdates an existing campaign.