- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Lists the promotions in your Merchant Center account. The response might contain fewer items than specified by pageSize
. Rely on pageToken
to determine if there are more items to be requested.
After inserting or updating a promotion, it may take several minutes before the updated processed promotion can be retrieved.
HTTP request
GET https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
parent
|
Required. The account to list processed promotions for. Format: |
Query parameters
| Parameters | |
|---|---|
pageSize
|
Optional. The maximum number of promotions to return. The service may return fewer than this value. The maximum value is 250; values above 250 will be coerced to 250. If unspecified, the maximum number of promotions will be returned. |
pageToken
|
Optional. A page token, received from a previous When paginating, all other parameters provided to |
Request body
The request body must be empty.
Response body
Response message for the promotions.list
method.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"promotions"
:
[
{
object (
|
| Fields | |
|---|---|
promotions[]
|
The processed promotions from the specified account. |
nextPageToken
|
A token, which can be sent as |
Authorization scopes
Requires the following OAuth scope:
-
https://www.googleapis.com/auth/content
For more information, see the OAuth 2.0 Overview .
