Merchant API v1beta was discontinued and shut down on February 28, 2026. For steps to transition to the latest stable version, see Migrate from v1beta to v1.

ListPromotions

ListPromotions
`rpc ListPromotions( ListPromotionsRequest ) returns ( ListPromotionsResponse )` 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. Authorization scopes Requires the following OAuth scope: `https://www.googleapis.com/auth/content` For more information, see the OAuth 2.0 Overview .

rpc ListPromotions( ListPromotionsRequest ) returns ( ListPromotionsResponse )

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.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview .

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-07-01 UTC.

ListPromotions Stay organized with collections Save and categorize content based on your preferences.

ListPromotions