Service to manage promotions for products.

For more information, see [Manage promotions](https://developers.google.com/merchant/api/guides/promotions/overview.md.txt) and [Troubleshoot issues](https://developers.google.com/merchant/api/guides/promotions/troubleshooting.md.txt).

| [GetPromotion](https://developers.google.com/merchant/api/reference/rpc/google.shopping.merchant.promotions.v1/PromotionsService/GetPromotion.md.txt) |
|---|
| `` rpc GetPromotion(`GetPromotionRequest`) returns (`Promotion`) `` 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. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/content` For more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2). |

| [InsertPromotion](https://developers.google.com/merchant/api/reference/rpc/google.shopping.merchant.promotions.v1/PromotionsService/InsertPromotion.md.txt) |
|---|
| `` rpc InsertPromotion(`InsertPromotionRequest`) returns (`Promotion`) `` Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead. Authorization scopes :   Requires the following OAuth scope: - `https://www.googleapis.com/auth/content` For more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2). |

| [ListPromotions](https://developers.google.com/merchant/api/reference/rpc/google.shopping.merchant.promotions.v1/PromotionsService/ListPromotions.md.txt) |
|---|
| `` 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](https://developers.google.com/identity/protocols/OAuth2). |