- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
List all promotions from your Merchant Center account.
HTTP request
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
Path parameters
Parameters | |
---|---|
merchant |
Required. The ID of the account that contains the collection. |
Query parameters
Parameters | |
---|---|
page |
The maximum number of promotions to return. The service may return fewer than this value. If unspecified, at most 50 labels will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. |
page |
A page token, received from a previous |
country |
CLDR country code (for example, "US"), used as a filter on promotions target country. |
language |
The two-letter ISO 639-1 language code associated with the promotions, used as a filter. |
Request body
The request body must be empty.
Response body
Response message for Promotions.List method.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"promotions": [
{
object ( |
Fields | |
---|---|
promotions[] |
List of all available promotions for the merchant. |
next |
A token, which can be sent as |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/content
For more information, see the OAuth 2.0 Overview.