Required. The ID of the account that contains the collection.
Query parameters
Parameters
pageSize
integer
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.
pageToken
string
A page token, received from a previouspromotions.listcall. Provide this to retrieve the subsequent page. When paginating, all other parameters provided topromotions.listmust match the call that provided the page token.
countryCode
string
CLDR country code(for example, "US"), used as a filter on promotions target country.
languageCode
string
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:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-25 UTC."],[],["This document outlines how to list promotions from a Merchant Center account using an HTTP GET request. The request URL includes a `merchantId` path parameter. Optional query parameters include `pageSize`, `pageToken`, `countryCode`, and `languageCode` for filtering and pagination. The request body is empty. The successful response contains a list of `promotions` and a `nextPageToken` for further pagination. The process requires OAuth 2.0 authorization with the `https://www.googleapis.com/auth/content` scope.\n"],null,[]]