<button class="button button-with-icon cloud-select-dropdown__button button-primary" aria-haspopup="true">On-premises or any cloud edition v1.15</button>

- [SAP BTP edition v1.1](https://docs.cloud.google.com/sap/docs/abap-sdk/btp/latest/reference/googcl_merchantapi_promotion)
- [On-premises or any cloud edition v1.15](https://docs.cloud.google.com/sap/docs/abap-sdk/on-premises-or-any-cloud/latest/reference/googcl_merchantapi_promotion.md.txt)

## Class

```abap
/GOOG/CL_MERCHANTAPI_PROMOTION
```

- Inheriting from:`/GOOG/CL_HTTP_CLIENT`
- Description:`Merchant API promotions_v1beta`

For general information about a class in ABAP SDK for Google Cloud, see [API client stub](https://docs.cloud.google.com/sap/docs/abap-sdk/latest/developer#client_stub).

## Types

| Type | Description | Visibility |
|---|---|---|
| `TY_001` | `Attributes` | PUBLIC |
| `TY_002` | `CustomAttribute` | PUBLIC |
| `TY_003` | `DestinationStatus` | PUBLIC |
| `TY_004` | `InsertPromotionRequest` | PUBLIC |
| `TY_005` | `Interval` | PUBLIC |
| `TY_006` | `ItemLevelIssue` | PUBLIC |
| `TY_007` | `ListPromotionsResponse` | PUBLIC |
| `TY_008` | `Price` | PUBLIC |
| `TY_010` | `Promotion` | PUBLIC |
| `TY_011` | `PromotionStatus` | PUBLIC |
| `TY_T_002` | `CustomAttribute` | PUBLIC |
| `TY_T_003` | `DestinationStatus` | PUBLIC |
| `TY_T_006` | `ItemLevelIssue` | PUBLIC |
| `TY_T_010` | `Promotion` | PUBLIC |
| `TY_T_STRING` | `Table of Strings` | PUBLIC |

## Constants

| Name | Type | Description | Value | Visibility |
|---|---|---|---|---|
| `C_CLOUD_VERSION` | `/GOOG/SDK_VERSION` | Lowest Cloud Version |   | PUBLIC |
| `C_ON_PREM_VERSION` | `/GOOG/SDK_VERSION` | Lowest On-premises Version | 1.7 | PUBLIC |
| `C_PATH_PREFIX` | `STRING` | API Path Prefix |   | PUBLIC |
| `C_REVISION_DATE` | `DATUM` | Discovery Document revision Date | 20250301 | PUBLIC |
| `C_ROOT_URL` | `STRING` | API Root URL | https://merchantapi.googleapis.com | PUBLIC |
| `C_SERVICE_NAME` | `/GOOG/SERVICE_NAME` | Google Service Name | merchantapi:promotions_v1beta | PUBLIC |
| `C_SUPPORTED_AUTH` | `/GOOG/SUPP_AUTH` | Supported Auth Types | IJIJWW | PUBLIC |

## Methods

For general information about a method in ABAP SDK for Google Cloud, see [API method](https://docs.cloud.google.com/sap/docs/abap-sdk/latest/developer#api_method).

### CONSTRUCTOR

- Description: Constructor
- Visibility: PUBLIC

#### Parameters

| Name | Category | Type | Description |
|---|---|---|---|
| `IV_KEY_NAME` | IMPORTING | `/GOOG/KEYNAME` | Google Cloud Key Name |
| `IV_LOG_OBJ` | IMPORTING | `BALOBJ_D` | Application log: Object name (Application code) |
| `IV_LOG_SUBOBJ` | IMPORTING | `BALSUBOBJ` | Application Log: Subobject |

#### Exception

| Name | Description |
|---|---|
| `/GOOG/CX_SDK` | ABAP SDK for Google Cloud: Exception Class |

### GET_PROMOTIONS

- Description: merchantapi.accounts.promotions.get
- Visibility: PUBLIC

#### Parameters

| Name | Category | Type | Description |
|---|---|---|---|
| `IV_P_ACCOUNTS_ID` | IMPORTING | `STRING` | accountsId |
| `IV_P_PROMOTIONS_ID` | IMPORTING | `STRING` | promotionsId |
| `ES_RAW` | EXPORTING | `DATA` | Raw Output Data |
| `ES_OUTPUT` | EXPORTING | `TY_010` | Promotion |
| `EV_RET_CODE` | EXPORTING | `I` | Return Code |
| `EV_ERR_TEXT` | EXPORTING | `STRING` | Error Text |
| `ES_ERR_RESP` | EXPORTING | `/GOOG/ERR_RESP` | Error Response |

#### Exception

| Name | Description |
|---|---|
| `/GOOG/CX_SDK` | ABAP SDK for Google Cloud: Exception Class |

### INSERT_PROMOTIONS

- Description: merchantapi.accounts.promotions.insert
- Visibility: PUBLIC

#### Parameters

| Name | Category | Type | Description |
|---|---|---|---|
| `IV_P_ACCOUNTS_ID` | IMPORTING | `STRING` | accountsId |
| `IS_INPUT` | IMPORTING | `TY_004` | InsertPromotionRequest |
| `ES_RAW` | EXPORTING | `DATA` | Raw Output Data |
| `ES_OUTPUT` | EXPORTING | `TY_010` | Promotion |
| `EV_RET_CODE` | EXPORTING | `I` | Return Code |
| `EV_ERR_TEXT` | EXPORTING | `STRING` | Error Text |
| `ES_ERR_RESP` | EXPORTING | `/GOOG/ERR_RESP` | Error Response |

#### Exception

| Name | Description |
|---|---|
| `/GOOG/CX_SDK` | ABAP SDK for Google Cloud: Exception Class |

### LIST_PROMOTIONS

- Description: merchantapi.accounts.promotions.list
- Visibility: PUBLIC

#### Parameters

| Name | Category | Type | Description |
|---|---|---|---|
| `IV_Q_PAGESIZE` | IMPORTING | `STRING` | pageSize |
| `IV_Q_PAGETOKEN` | IMPORTING | `STRING` | pageToken |
| `IV_P_ACCOUNTS_ID` | IMPORTING | `STRING` | accountsId |
| `ES_RAW` | EXPORTING | `DATA` | Raw Output Data |
| `ES_OUTPUT` | EXPORTING | `TY_007` | ListPromotionsResponse |
| `EV_RET_CODE` | EXPORTING | `I` | Return Code |
| `EV_ERR_TEXT` | EXPORTING | `STRING` | Error Text |
| `ES_ERR_RESP` | EXPORTING | `/GOOG/ERR_RESP` | Error Response |

#### Exception

| Name | Description |
|---|---|
| `/GOOG/CX_SDK` | ABAP SDK for Google Cloud: Exception Class |

### CLOSE

- Description: Close Connection
- Visibility: PUBLIC