dfareporting.advertiser Groups.list

GET {{baseUrl}}/userprofiles/:profileId/advertiserGroups?ids=<string>&ids=<string>&maxResults=<integer>&pageToken=<string>&searchString=<string>&sortField=<string>&sortOrder=<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 advertiser groups, possibly filtered. This method supports paging.

Request Params

KeyDatatypeRequiredDescription
idsstringSelect only advertiser groups with these IDs.
idsstringSelect only advertiser groups with these IDs.
maxResultsstringMaximum number of results to return.
pageTokenstringValue of the nextPageToken from the previous result page.
searchStringstringAllows searching for objects by name or ID. Wildcards () are allowed. For example, "advertiser2015" will return objects with names like "advertiser group June 2015", "advertiser group April 2015", or simply "advertiser group 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 "advertisergroup" will match objects with name "my advertisergroup", "advertisergroup 2015", or simply "advertisergroup".
sortFieldstringField by which to sort the list.
sortOrderstringOrder of sorted results.
$.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;advertiserGroups&quot;:[{&quot;accountId&quot;:&quot;voluptate fugiat minim ut&quot;,&quot;id&quot;:&quot;eu laboris&quot;,&quot;kind&quot;:&quot;esse ut&quot;,&quot;name&quot;:&quot;labore dolor quis&quot;},{&quot;accountId&quot;:&quot;exercitation in pariatur Excepteur&quot;,&quot;id&quot;:&quot;Duis et dolor pariatur&quot;,&quot;kind&quot;:&quot;do esse&quot;,&quot;name&quot;:&quot;exercitation est&quot;}],&quot;kind&quot;:&quot;id proident&quot;,&quot;nextPageToken&quot;:&quot;&quot;}