Method: accounts.list

HTTP request
Query parameters
Request body
Response body
- JSON representation
Authorization scopes
Try it!

Note: For the accounts.list method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. To list several sub-accounts, you should use the accounts.listSubaccounts method, which is more suitable for advanced accounts use case.

HTTP request

GET https://merchantapi.googleapis.com/accounts/v1/accounts

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters

Parameters
`pageSize`	`integer` Optional. The maximum number of accounts to return. The service may return fewer than this value. If unspecified, at most 250 accounts are returned. The maximum value is 500; values above 500 are coerced to 500.
`pageToken`	`string` Optional. A page token, received from a previous `accounts.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided in the `accounts.list` request must match the call that provided the page token.
`filter`	`string` Optional. Returns only accounts that match the filter . For more details, see the filter syntax reference .

pageSize

integer

Optional. The maximum number of accounts to return. The service may return fewer than this value. If unspecified, at most 250 accounts are returned. The maximum value is 500; values above 500 are coerced to 500.

pageToken

string

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

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

filter

string

Optional. Returns only accounts that match the filter . For more details, see the filter syntax reference .

Request body

The request body must be empty.

Response body

Response message for the accounts.list method.

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

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

Fields

Fields
`accounts[]`	`object ( Account )` The accounts matching the `ListAccountsRequest` .
`nextPageToken`	`string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages.

accounts[]

object ( Account )

The accounts matching the ListAccountsRequest .

nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization scopes

Requires the following OAuth scope:

https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview .

Method: accounts.list Stay organized with collections Save and categorize content based on your preferences.

HTTP request

Query parameters

Request body

Response body

Authorization scopes

Method: accounts.list