Method: accounts.list

  • This document details how to list all AdSense accounts available to a user via an HTTP GET request.

  • The request uses the URL https://adsense.googleapis.com/v2/accounts and can include pageSize and pageToken query parameters for pagination.

  • The request body must be empty, and the successful response body contains a list of accounts and an optional nextPageToken.

  • Authorization requires one of the specified OAuth scopes: https://www.googleapis.com/auth/adsense or https://www.googleapis.com/auth/adsense.readonly.

Lists all accounts available to this user.

HTTP request

GET https://adsense.googleapis.com/v2/accounts

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
pageSize

integer

The maximum number of accounts to include in the response, used for paging. If unspecified, at most 10000 accounts 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 accounts.list call. Provide this to retrieve the subsequent page.

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

Request body

The request body must be empty.

Response body

Response definition for the account list rpc.

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

JSON representation
{
  "accounts": [
    {
      object (Account)
    }
  ],
  "nextPageToken": string
}
Fields
accounts[]

object (Account)

The accounts returned in this list response.

nextPageToken

string

Continuation token used to page through accounts. 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