dfareporting.campaigns.list

GET {{baseUrl}}/userprofiles/:profileId/campaigns?advertiserGroupIds=<string>&advertiserGroupIds=<string>&advertiserIds=<string>&advertiserIds=<string>&archived=<boolean>&atLeastOneOptimizationActivity=<boolean>&excludedIds=<string>&excludedIds=<string>&ids=<string>&ids=<string>&maxResults=<integer>&overriddenEventTagId=<string>&pageToken=<string>&searchString=<string>&sortField=<string>&sortOrder=<string>&subaccountId=<string>&$.xgafv=<string>&access_token=<string>&alt=<string>&callback=<string>&fields=<string>&key=<string>&oauth_token=<string>&prettyPrint=<boolean>&quotaUser=<string>&upload_protocol=<string>&uploadType=<string>

Retrieves a list of campaigns, possibly filtered. This method supports paging.

Request Params

KeyDatatypeRequiredDescription
advertiserGroupIdsstringSelect only campaigns whose advertisers belong to these advertiser groups.
advertiserGroupIdsstringSelect only campaigns whose advertisers belong to these advertiser groups.
advertiserIdsstringSelect only campaigns that belong to these advertisers.
advertiserIdsstringSelect only campaigns that belong to these advertisers.
archivedstringSelect only archived campaigns. Don't set this field to select both archived and non-archived campaigns.
atLeastOneOptimizationActivitystringSelect only campaigns that have at least one optimization activity.
excludedIdsstringExclude campaigns with these IDs.
excludedIdsstringExclude campaigns with these IDs.
idsstringSelect only campaigns with these IDs.
idsstringSelect only campaigns with these IDs.
maxResultsstringMaximum number of results to return.
overriddenEventTagIdstringSelect only campaigns that have overridden this event tag ID.
pageTokenstringValue of the nextPageToken from the previous result page.
searchStringstringAllows searching for campaigns by name or ID. Wildcards () are allowed. For example, "campaign2015" will return campaigns with names like "campaign June 2015", "campaign April 2015", or simply "campaign 2015". Most of the searches also add wildcards implicitly at the start and the end of the search string. For example, a search string of "campaign" will match campaigns with name "my campaign", "campaign 2015", or simply "campaign".
sortFieldstringField by which to sort the list.
sortOrderstringOrder of sorted results.
subaccountIdstringSelect only campaigns that belong to this subaccount.
$.xgafvstringV1 error format.
access_tokenstringOAuth access token.
altstringData format for response.
callbackstringJSONP
fieldsstringSelector specifying which fields to include in a partial response.
keystringAPI key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
oauth_tokenstringOAuth 2.0 token for the current user.
prettyPrintstringReturns response with indentations and line breaks.
quotaUserstringAvailable to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
upload_protocolstringUpload protocol for media (e.g. "raw", "multipart").
uploadTypestringLegacy upload protocol for media (e.g. "media", "multipart").

RESPONSES

status: OK

{&quot;campaigns&quot;:[{&quot;accountId&quot;:&quot;reprehenderit pariatur adipisicing&quot;,&quot;adBlockingConfiguration&quot;:{&quot;clickThroughUrl&quot;:&quot;dolore tempor laborum voluptate cupidatat&quot;,&quot;creativeBundleId&quot;:&quot;sint est non do enim&quot;,&quot;enabled&quot;:false,&quot;overrideClickThroughUrl&quot;:true},&quot;additionalCreativeOptimizationConfigurations&quot;:[{&quot;id&quot;:&quot;velit sed&quot;,&quot;name&quot;:&quot;Duis id qui culpa nulla&quot;,&quot;optimizationActivitys&quot;:[{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}],&quot;optimizationModel&quot;:&quot;POST_CLICK&quot;},{&quot;id&quot;:&quot;laborum veniam&quot;,&quot;name&quot;:&quot;est&quot;,&quot;optimizationActivitys&quot;:[{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}],&quot;optimizationModel&quot;:&quot;POST_CLICK_AND_IMPRESSION&quot;}],&quot;advertiserGroupId&quot;:&quot;id aliqui&quot;,&quot;advertiserId&quot;:&quot;occaecat amet ut&quot;,&quot;advertiserIdDimensionValue&quot;:{&quot;dimensionName&quot;:&quot;dolor Duis&quot;,&quot;etag&quot;:&quot;Ut&quot;,&quot;id&quot;:&quot;nisi&quot;,&quot;kind&quot;:&quot;Excepteur aute aliquip ex&quot;,&quot;matchType&quot;:&quot;EXACT&quot;,&quot;value&quot;:&quot;dolore officia ut sunt&quot;},&quot;archived&quot;:true,&quot;audienceSegmentGroups&quot;:[{&quot;audienceSegments&quot;:[{&quot;allocation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;name&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;allocation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;name&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}],&quot;id&quot;:&quot;ex elit&quot;,&quot;name&quot;:&quot;exercitation dolore&quot;},{&quot;audienceSegments&quot;:[{&quot;allocation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;name&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;allocation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;name&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}],&quot;id&quot;:&quot;aliquip non sunt&quot;,&quot;name&quot;:&quot;adipisicing sunt amet deserunt culpa&quot;}],&quot;billingInvoiceCode&quot;:&quot;elit Excepteur do dolor irure&quot;,&quot;clickThroughUrlSuffixProperties&quot;:{&quot;clickThroughUrlSuffix&quot;:&quot;officia&quot;,&quot;overrideInheritedSuffix&quot;:true},&quot;comment&quot;:&quot;dolor aute consequat&quot;,&quot;createInfo&quot;:{&quot;time&quot;:&quot;deserunt nostrud et dolore&quot;},&quot;creativeGroupIds&quot;:[&quot;dolore eiusmod&quot;,&quot;ut occaecat officia&quot;],&quot;creativeOptimizationConfiguration&quot;:{&quot;id&quot;:&quot;Ut ad culpa&quot;,&quot;name&quot;:&quot;E&quot;,&quot;optimizationActivitys&quot;:[{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}],&quot;optimizationModel&quot;:&quot;POST_CLICK&quot;},&quot;defaultClickThroughEventTagProperties&quot;:{&quot;defaultClickThroughEventTagId&quot;:&quot;tempor labore&quot;,&quot;overrideInheritedEventTag&quot;:false},&quot;defaultLandingPageId&quot;:&quot;sint id non&quot;,&quot;endDate&quot;:&quot;1972-12-05&quot;,&quot;eventTagOverrides&quot;:[{&quot;enabled&quot;:true,&quot;id&quot;:&quot;ullamco exercitation consectetur&quot;},{&quot;enabled&quot;:false,&quot;id&quot;:&quot;proident veniam tempor&quot;}],&quot;externalId&quot;:&quot;esse adipisicing occaecat in&quot;,&quot;id&quot;:&quot;dolore aliqua qui et&quot;,&quot;idDimensionValue&quot;:{&quot;dimensionName&quot;:&quot;occaecat sed exercitation&quot;,&quot;etag&quot;:&quot;proident fugiat&quot;,&quot;id&quot;:&quot;eu qui&quot;,&quot;kind&quot;:&quot;dolor ut eu elit&quot;,&quot;matchType&quot;:&quot;EXACT&quot;,&quot;value&quot;:&quot;occaecat do&quot;},&quot;kind&quot;:&quot;veniam&quot;,&quot;lastModifiedInfo&quot;:{&quot;time&quot;:&quot;minim elit aute&quot;},&quot;name&quot;:&quot;Ut Excepteur ex&quot;,&quot;nielsenOcrEnabled&quot;:false,&quot;startDate&quot;:&quot;1996-04-30&quot;,&quot;subaccountId&quot;:&quot;exercitation adipisicing commodo occaecat&quot;,&quot;traffickerEmails&quot;:[&quot;elit&quot;,&quot;ex pariatur&quot;]},{&quot;accountId&quot;:&quot;eu ipsum dolore aliqua&quot;,&quot;adBlockingConfiguration&quot;:{&quot;clickThroughUrl&quot;:&quot;sint dolore&quot;,&quot;creativeBundleId&quot;:&quot;deserunt fugiat sint aute&quot;,&quot;enabled&quot;:true,&quot;overrideClickThroughUrl&quot;:false},&quot;additionalCreativeOptimizationConfigurations&quot;:[{&quot;id&quot;:&quot;amet sint eu exercitation cillum&quot;,&quot;name&quot;:&quot;anim minim ullamco&quot;,&quot;optimizationActivitys&quot;:[{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}],&quot;optimizationModel&quot;:&quot;VIDEO_COMPLETION&quot;},{&quot;id&quot;:&quot;in pariatur&quot;,&quot;name&quot;:&quot;qui pa&quot;,&quot;optimizationActivitys&quot;:[{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}],&quot;optimizationModel&quot;:&quot;CLICK&quot;}],&quot;advertiserGroupId&quot;:&quot;in aute commodo aliquip&quot;,&quot;advertiserId&quot;:&quot;ipsum&quot;,&quot;advertiserIdDimensionValue&quot;:{&quot;dimensionName&quot;:&quot;tempor et Lorem laborum&quot;,&quot;etag&quot;:&quot;laboris consectetur Lorem ut sit&quot;,&quot;id&quot;:&quot;in ad incididunt dolor&quot;,&quot;kind&quot;:&quot;elit ci&quot;,&quot;matchType&quot;:&quot;BEGINS_WITH&quot;,&quot;value&quot;:&quot;laborum&quot;},&quot;archived&quot;:false,&quot;audienceSegmentGroups&quot;:[{&quot;audienceSegments&quot;:[{&quot;allocation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;name&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;allocation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;name&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}],&quot;id&quot;:&quot;Excepteur incididunt&quot;,&quot;name&quot;:&quot;ut labore pariatur&quot;},{&quot;audienceSegments&quot;:[{&quot;allocation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;name&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;allocation&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;id&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;name&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}],&quot;id&quot;:&quot;nulla reprehenderit esse &quot;,&quot;name&quot;:&quot;Ut occaecat&quot;}],&quot;billingInvoiceCode&quot;:&quot;irure labore cillum reprehenderit eu&quot;,&quot;clickThroughUrlSuffixProperties&quot;:{&quot;clickThroughUrlSuffix&quot;:&quot;laborum officia in&quot;,&quot;overrideInheritedSuffix&quot;:false},&quot;comment&quot;:&quot;irure et&quot;,&quot;createInfo&quot;:{&quot;time&quot;:&quot;Lorem &quot;},&quot;creativeGroupIds&quot;:[&quot;sed quis dolore&quot;,&quot;velit&quot;],&quot;creativeOptimizationConfiguration&quot;:{&quot;id&quot;:&quot;in velit&quot;,&quot;name&quot;:&quot;sint ullamco&quot;,&quot;optimizationActivitys&quot;:[{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}},{&quot;floodlightActivityId&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;floodlightActivityIdDimensionValue&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;},&quot;weight&quot;:{&quot;value&quot;:&quot;\u003cError: Too many levels of nesting to fake this schema\u003e&quot;}}],&quot;optimizationModel&quot;:&quot;CLICK&quot;},&quot;defaultClickThroughEventTagProperties&quot;:{&quot;defaultClickThroughEventTagId&quot;:&quot;tempor elit Ut&quot;,&quot;overrideInheritedEventTag&quot;:true},&quot;defaultLandingPageId&quot;:&quot;culpa eu&quot;,&quot;endDate&quot;:&quot;1945-03-01&quot;,&quot;eventTagOverrides&quot;:[{&quot;enabled&quot;:false,&quot;id&quot;:&quot;fugiat ullamco proident&quot;},{&quot;enabled&quot;:true,&quot;id&quot;:&quot;ad nulla pariatur&quot;}],&quot;externalId&quot;:&quot;aliquip ea labore dolore deser&quot;,&quot;id&quot;:&quot;eu cupidatat&quot;,&quot;idDimensionValue&quot;:{&quot;dimensionName&quot;:&quot;adipisicing laboris sed labore eu&quot;,&quot;etag&quot;:&quot;ad qui&quot;,&quot;id&quot;:&quot;irure proident ex&quot;,&quot;kind&quot;:&quot;cillum in&quot;,&quot;matchType&quot;:&quot;EXACT&quot;,&quot;value&quot;:&quot;et sed dolor dolore&quot;},&quot;kind&quot;:&quot;ut&quot;,&quot;lastModifiedInfo&quot;:{&quot;time&quot;:&quot;Lorem eu non&quot;},&quot;name&quot;:&quot;laboris Ut amet dolore&quot;,&quot;nielsenOcrEnabled&quot;:false,&quot;startDate&quot;:&quot;1996-03-26&quot;,&quot;subaccountId&quot;:&quot;ea est incididunt&quot;,&quot;traffickerEmails&quot;:[&quot;dolor&quot;,&quot;do non velit&quot;]}],&quot;kind&quot;:&quot;aliqua qui commodo&quot;,&quot;nextPageToken&quot;:&quot;velit id amet in&quot;}