dfareporting.advertisers.list
GET {{baseUrl}}/userprofiles/:profileId/advertisers?advertiserGroupIds=<string>&advertiserGroupIds=<string>&floodlightConfigurationIds=<string>&floodlightConfigurationIds=<string>&ids=<string>&ids=<string>&includeAdvertisersWithoutGroupsOnly=<boolean>&maxResults=<integer>&onlyParent=<boolean>&pageToken=<string>&searchString=<string>&sortField=<string>&sortOrder=<string>&status=<string>&subaccountId=<string>&$.xgafv=<string>&access_token=<string>&alt=<string>&callback=<string>&fields=<string>&key=<string>&oauth_token=<string>&prettyPrint=<boolean>"aUser=<string>&upload_protocol=<string>&uploadType=<string>
Retrieves a list of advertisers, possibly filtered. This method supports paging.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
advertiserGroupIds | string | Select only advertisers with these advertiser group IDs. | |
advertiserGroupIds | string | Select only advertisers with these advertiser group IDs. | |
floodlightConfigurationIds | string | Select only advertisers with these floodlight configuration IDs. | |
floodlightConfigurationIds | string | Select only advertisers with these floodlight configuration IDs. | |
ids | string | Select only advertisers with these IDs. | |
ids | string | Select only advertisers with these IDs. | |
includeAdvertisersWithoutGroupsOnly | string | Select only advertisers which do not belong to any advertiser group. | |
maxResults | string | Maximum number of results to return. | |
onlyParent | string | Select only advertisers which use another advertiser's floodlight configuration. | |
pageToken | string | Value of the nextPageToken from the previous result page. | |
searchString | string | Allows searching for objects by name or ID. Wildcards () are allowed. For example, "advertiser2015" will return objects with names like "advertiser June 2015", "advertiser April 2015", or simply "advertiser 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 "advertiser" will match objects with name "my advertiser", "advertiser 2015", or simply "advertiser" . | |
sortField | string | Field by which to sort the list. | |
sortOrder | string | Order of sorted results. | |
status | string | Select only advertisers with the specified status. | |
subaccountId | string | Select only advertisers with these subaccount IDs. | |
$.xgafv | string | V1 error format. | |
access_token | string | OAuth access token. | |
alt | string | Data format for response. | |
callback | string | JSONP | |
fields | string | Selector specifying which fields to include in a partial response. | |
key | string | API 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_token | string | OAuth 2.0 token for the current user. | |
prettyPrint | string | Returns response with indentations and line breaks. | |
quotaUser | string | Available 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_protocol | string | Upload protocol for media (e.g. "raw", "multipart"). | |
uploadType | string | Legacy upload protocol for media (e.g. "media", "multipart"). |
RESPONSES
status: OK
{"advertisers":[{"accountId":"nostrud ea","advertiserGroupId":"ea deserunt pariatur","clickThroughUrlSuffix":"tempor consectetur aliquip reprehenderit ex","defaultClickThroughEventTagId":"reprehenderit sed voluptate","defaultEmail":"in Excepteur eu aute non","floodlightConfigurationId":"i","floodlightConfigurationIdDimensionValue":{"dimensionName":"enim cupidatat esse","etag":"eu ut amet","id":"veniam tempor magna","kind":"ut amet","matchType":"WILDCARD_EXPRESSION","value":"nulla aute laboris do"},"id":"Lorem cillum magna","idDimensionValue":{"dimensionName":"consequat","etag":"sit","id":"incididunt nulla ex","kind":"D","matchType":"WILDCARD_EXPRESSION","value":"id aliquip pariatur"},"kind":"do reprehenderit","name":"aliqua adipisicing est irure","originalFloodlightConfigurationId":"nostrud ipsum","status":"APPROVED","subaccountId":"fugiat esse consequat pariatur","suspended":true},{"accountId":"consectetur cillum","advertiserGroupId":"sunt nisi consectetur","clickThroughUrlSuffix":"eiusmod","defaultClickThroughEventTagId":"et id reprehenderit","defaultEmail":"qui cupidatat","floodlightConfigurationId":"ullamco","floodlightConfigurationIdDimensionValue":{"dimensionName":"in qui aute Ut","etag":"nisi sit","id":"consequat commodo ut sed","kind":"ex","matchType":"CONTAINS","value":"amet velit voluptate Lorem"},"id":"proident ut","idDimensionValue":{"dimensionName":"qui ipsum","etag":"Duis Ut culpa","id":"occaecat Lorem magna ad","kind":"dolore voluptate aliquip","matchType":"WILDCARD_EXPRESSION","value":"dolore in irure officia dolore"},"kind":"do incididunt","name":"occaecat aliqua mollit","originalFloodlightConfigurationId":"est mollit ea sunt Duis","status":"ON_HOLD","subaccountId":"Ut","suspended":false}],"kind":"in quis","nextPageToken":"proident"}