Retrieves a list of advertiser groups, possibly filtered. This method supports paging. Try it now.
Request
HTTP request
GET https://www.googleapis.com/dfareporting/v3.4/userprofiles/profileId/advertiserGroups
Parameters
Parameter name | Value | Description |
---|---|---|
Path parameters | ||
profileId |
long |
User profile ID associated with this request. |
Optional query parameters | ||
ids |
long |
Select only advertiser groups with these IDs. |
maxResults |
integer |
Maximum number of results to return.
Acceptable values are 0 to 1000 , inclusive.
(Default: 1000 )
|
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, "advertiser*2015" 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" .
|
sortField |
string |
Field by which to sort the list.
Acceptable values are:
|
sortOrder |
string |
Order of sorted results.
Acceptable values are:
|
Authorization
This request requires authorization with the following scope:
Scope |
---|
https://www.googleapis.com/auth/dfatrafficking |
For more information, see the authentication and authorization page.
Request body
Do not supply a request body with this method.
Response
If successful, this method returns a response body with the following structure:
{ "kind": "dfareporting#advertiserGroupsListResponse", "nextPageToken": string, "advertiserGroups": [ advertiserGroups Resource ] }
Property name | Value | Description | Notes |
---|---|---|---|
kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dfareporting#advertiserGroupsListResponse" . |
|
advertiserGroups[] |
list |
Advertiser group collection. | |
nextPageToken |
string |
Pagination token to be used for the next list operation. |
Try it!
Use the APIs Explorer below to call this method on live data and see the response.