Adunits: list

Deprecated: Due to the possibility of ambiguity, accounts with both an AdSense publisher account and an AdExchange account will throw an error when trying to use the default account. Always use accounts.list to check if there's more than one account and let the user choose in that case. After that, specify the account ID on every call using the /accounts/ namespace.

Requires authorization

List all ad units in the specified ad client for this AdSense account. Try it now.

Request

HTTP request

GET https://www.googleapis.com/adsense/v1.4/adclients/adClientId/adunits

Parameters

Parameter name	Value	Description
Path parameters
`adClientId`	`string`	Ad client for which to list ad units.
Optional query parameters
`includeInactive`	`boolean`	Whether to include inactive ad units. Default: true.
`maxResults`	`integer`	The maximum number of ad units to include in the response, used for paging. Acceptable values are `0` to `10000`, inclusive.
`pageToken`	`string`	A continuation token, used to page through ad units. To retrieve the next page, set this parameter to the value of "nextPageToken" from the previous response.

Authorization

This request requires authorization with at least one of the following scopes (read more about authentication and authorization).

Scope
`https://www.googleapis.com/auth/adsense`
`https://www.googleapis.com/auth/adsense.readonly`

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": "adsense#adUnits",
  "etag": etag,
  "nextPageToken": string,
  "items": [
    adunits Resource
  ]
}

Property name	Value	Description
`kind`	`string`	Kind of list this is, in this case adsense#adUnits.
`etag`	`etag`	ETag of this response for caching purposes.
`nextPageToken`	`string`	Continuation token used to page through ad units. To retrieve the next page of results, set the next request's "pageToken" value to this.
`items[]`	`list`	The ad units returned in this list response.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.