Method: accounts.list

  • Lists sub-accounts within a multi-client Merchant Center account, offering pagination and filtering options.

  • Supports customizing the data returned using the view parameter with options like "merchant" and "css".

  • Requires authorization with the https://www.googleapis.com/auth/content scope.

  • Provides details about the HTTP request, path and query parameters, response structure, and authorization.

  • Allows retrieval of account information including a next page token for accessing further results.

Lists the sub-accounts in your Merchant Center account.

HTTP request

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts

Path parameters

Parameters
merchantId

string

The ID of the managing account. This must be a multi-client account.

Query parameters

Parameters
maxResults

integer (uint32 format)

The maximum number of accounts to return in the response, used for paging.
pageToken

string

The token returned by the previous request.
view

enum (View)

Controls which fields will be populated. Acceptable values are: "merchant" and "css". The default value is "merchant".
label

string

If view is set to "css", only return accounts that are assigned label with given ID.
name

string

If set, only the accounts with the given name (case sensitive) will be returned.

Request body

The request body must be empty.

Response body

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

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

string

The token for the retrieval of the next page of accounts.
kind

string

Identifies what kind of resource this is. Value: the fixed string "content#accountsListResponse".
resources[]

object (Account)

Authorization scopes

Requires one of the following OAuth scopes:

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

For more information, see the OAuth 2.0 Overview.

View

Enums
MERCHANT Default. View is populated with Merchant Center fields.
CSS View is populated with Comparison Shopping Services fields.