v1.4 of the AdSense Management API is now deprecated. This version will stop returning data on October 12, 2021. Please migrate to v2 as soon as possible.

Method: accounts.adclients.adunits.list

Lists all ad units under a specified account and ad client.

HTTP request

GET https://adsense.googleapis.com/v2/{parent=accounts/*/adclients/*}/adunits

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The ad client which owns the collection of ad units. Format: accounts/{account}/adclients/{adclient}

Query parameters

Parameters
pageSize

integer

The maximum number of ad units to include in the response, used for paging. If unspecified, at most 10000 ad units will be returned. The maximum value is 10000; values above 10000 will be coerced to 10000.

pageToken

string

A page token, received from a previous adunits.list call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to adunits.list must match the call that provided the page token.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response definition for the adunit list rpc.

JSON representation
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
Fields
adUnits[]

object (AdUnit)

The ad units returned in the list response.

nextPageToken

string

Continuation token used to page through ad units. To retrieve the next page of the results, set the next request's "pageToken" value to this.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/adsense
  • https://www.googleapis.com/auth/adsense.readonly