Page Summary
-
Lists the statuses of sub-accounts within a multi-client Merchant Center account.
-
Allows filtering by name, destination, and pagination for large result sets.
-
Requires authorization with the
https://www.googleapis.com/auth/contentscope. -
Provides details on HTTP request structure, parameters, and the expected response format.
-
Employs a GET request to the specified endpoint with optional query parameters.
- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Lists the statuses of the sub-accounts in your Merchant Center account.
HTTP request
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accountstatuses
Path parameters
| Parameters | |
|---|---|
merchantId
|
The ID of the managing account. This must be a multi-client account. |
Query parameters
| Parameters | |
|---|---|
maxResults
|
The maximum number of account statuses to return in the response, used for paging. |
pageToken
|
The token returned by the previous request. |
destinations[]
|
If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination. |
name
|
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 (
|
| Fields | |
|---|---|
nextPageToken
|
The token for the retrieval of the next page of account statuses. |
kind
|
Identifies what kind of resource this is. Value: the fixed string " |
resources[]
|
|
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/content
For more information, see the OAuth 2.0 Overview .

