2026-11-05
▼ ▲ merchantapi.accounts.promotions.list
Description : 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.
Flat Path : promotions/v1beta/accounts/{accountsId}/promotions
Scopes : https://www.googleapis.com/auth/content
Parameter Order : parent
HTTP Method : GET
Parameters :
pageSize
Location : query
Format : int32
Description : 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.
Type : integer
pageToken
Type : string
Description : Optional. A page token, received from a previous `ListPromotions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPromotions` must match the call that provided the page token.
Location : query
parent
Pattern : ^accounts/[^/]+$
Required : Yes
Type : string
Location : path
Description : Required. The account to list processed promotions for. Format: `accounts/{account}`
Path : promotions/v1beta/{+parent}/promotions
▼ ▲ merchantapi.accounts.promotions.insert
Flat Path : promotions/v1beta/accounts/{accountsId}/promotions:insert
Path : promotions/v1beta/{+parent}/promotions:insert
Description : Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead.
Scopes : https://www.googleapis.com/auth/content
Parameter Order : parent
HTTP Method : POST
Parameters :
parent
Description : Required. The account where the promotion will be inserted. Format: accounts/{account}
Location : path
Required : Yes
Pattern : ^accounts/[^/]+$
Type : string
▼ ▲ merchantapi.accounts.promotions.get
Flat Path : promotions/v1beta/accounts/{accountsId}/promotions/{promotionsId}
Parameter Order : name
Scopes : https://www.googleapis.com/auth/content
HTTP Method : GET
Parameters :
name
Pattern : ^accounts/[^/]+/promotions/[^/]+$
Description : Required. The name of the promotion to retrieve. Format: `accounts/{account}/promotions/{promotions}`
Location : path
Type : string
Required : Yes
Description : Retrieves the promotion from your Merchant Center account. After inserting or updating a promotion input, it may take several minutes before the updated promotion can be retrieved.
Path : promotions/v1beta/{+name}