Method: accounts.promotions.list

  • Lists all processed promotions for a given Merchant Center account, allowing pagination for large result sets.

  • Provides detailed information about each promotion, including potential product restrictions and offer details.

  • Requires authorization with the https://www.googleapis.com/auth/content scope for access.

  • Responses may be delayed for recently created or updated promotions due to processing time.

  • Utilizes HTTP GET requests with path and query parameters for specifying the target account and pagination control.

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/v1beta/{parent=accounts/*}/promotions

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The account to list processed promotions for. Format: accounts/{account}

Query parameters

Parameters
pageSize

integer

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

string

Optional. A page token, received from a previous promotions.list call. Provide this to retrieve the subsequent page.

When paginating, all other parameters provided to promotions.list must match the call that provided the page token.

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 (Promotion)
    }
  ],
  "nextPageToken": string
}
Fields
promotions[]

object (Promotion)

The processed promotions from the specified account.
nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.