Method: accounts.list
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
GET https://admob.googleapis.com/v1/accounts
The URL uses gRPC Transcoding syntax.
Query parameters
| Parameters |
pageSize |
integer
Maximum number of accounts to return.
|
pageToken |
string
The value returned by the last ListPublisherAccountsResponse; indicates that this is a continuation of a prior accounts.list call, and that the system should return the next page of data.
|
Request body
The request body must be empty.
Response body
Response for the publisher account list request.
If successful, the response body contains data with the following structure:
| JSON representation |
{
"account": [
{
object (PublisherAccount)
}
],
"nextPageToken": string
} |
| Fields |
account[] |
object (PublisherAccount)
Publisher that the client credentials can access.
|
nextPageToken |
string
If not empty, indicates that there might be more accounts for the request; you must pass this value in a new ListPublisherAccountsRequest.
|
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/admob.readonly
https://www.googleapis.com/auth/admob.report
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[null,null,["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eLists the most recently signed-in AdMob publisher account and provides pagination for accessing more accounts.\u003c/p\u003e\n"],["\u003cp\u003eRequest an account list with optional parameters to specify the maximum number of accounts and page tokens for continuation.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of publisher accounts and a token for retrieving the next page if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for read-only or report access to AdMob data.\u003c/p\u003e\n"]]],["This document details how to retrieve a list of AdMob publisher accounts. Use a `GET` request to `https://admob.googleapis.com/v1/accounts`. The request body should be empty. Optional `pageSize` and `pageToken` query parameters control the number of accounts returned and pagination. The response body includes an array of account objects and an optional `nextPageToken` for further data retrieval. Access requires specific OAuth scopes: `admob.readonly` or `admob.report`.\n"],null,["# Method: accounts.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListPublisherAccountsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nLists the AdMob publisher account that was most recently signed in to from the AdMob UI. For more information, see \u003chttps://support.google.com/admob/answer/10243672\u003e.\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1/accounts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Maximum number of accounts to return. |\n| `pageToken` | `string` The value returned by the last `ListPublisherAccountsResponse`; indicates that this is a continuation of a prior `accounts.list` call, and that the system should return the next page of data. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the publisher account list request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"account\": [ { object (/admob/api/reference/rest/v1/accounts#PublisherAccount) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `account[]` | `object (`[PublisherAccount](/admob/api/reference/rest/v1/accounts#PublisherAccount)`)` Publisher that the client credentials can access. |\n| `nextPageToken` | `string` If not empty, indicates that there might be more accounts for the request; you must pass this value in a new `ListPublisherAccountsRequest`. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admob.readonly`\n- `\n https://www.googleapis.com/auth/admob.report`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
