ebay-api 8.4.1 → 8.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (394) hide show
  1. package/README.md +3 -3
  2. package/dist/api/apiFactory.d.ts +27 -27
  3. package/dist/api/apiFactory.js +94 -94
  4. package/dist/api/base.d.ts +10 -10
  5. package/dist/api/base.js +10 -10
  6. package/dist/api/digitalSignature.d.ts +43 -43
  7. package/dist/api/digitalSignature.js +105 -105
  8. package/dist/api/index.d.ts +13 -13
  9. package/dist/api/index.js +29 -29
  10. package/dist/api/restful/buy/browse/index.d.ts +84 -84
  11. package/dist/api/restful/buy/browse/index.js +132 -135
  12. package/dist/api/restful/buy/deal/index.d.ts +56 -55
  13. package/dist/api/restful/buy/deal/index.js +74 -73
  14. package/dist/api/restful/buy/feed/index.d.ts +44 -43
  15. package/dist/api/restful/buy/feed/index.js +79 -78
  16. package/dist/api/restful/buy/index.d.ts +17 -17
  17. package/dist/api/restful/buy/index.js +8 -8
  18. package/dist/api/restful/buy/marketing/index.d.ts +28 -27
  19. package/dist/api/restful/buy/marketing/index.js +45 -44
  20. package/dist/api/restful/buy/marketplaceInsights/index.d.ts +29 -28
  21. package/dist/api/restful/buy/marketplaceInsights/index.js +45 -44
  22. package/dist/api/restful/buy/offer/index.d.ts +24 -23
  23. package/dist/api/restful/buy/offer/index.js +31 -30
  24. package/dist/api/restful/buy/order/index.d.ts +265 -264
  25. package/dist/api/restful/buy/order/index.js +363 -362
  26. package/dist/api/restful/commerce/catalog/index.d.ts +74 -73
  27. package/dist/api/restful/commerce/catalog/index.js +100 -101
  28. package/dist/api/restful/commerce/charity/index.d.ts +35 -34
  29. package/dist/api/restful/commerce/charity/index.js +50 -49
  30. package/dist/api/restful/commerce/identity/index.d.ts +15 -14
  31. package/dist/api/restful/commerce/identity/index.js +21 -20
  32. package/dist/api/restful/commerce/index.d.ts +15 -15
  33. package/dist/api/restful/commerce/index.js +7 -7
  34. package/dist/api/restful/commerce/notification/index.d.ts +118 -117
  35. package/dist/api/restful/commerce/notification/index.js +181 -180
  36. package/dist/api/restful/commerce/taxonomy/index.d.ts +79 -78
  37. package/dist/api/restful/commerce/taxonomy/index.js +129 -128
  38. package/dist/api/restful/commerce/translation/index.d.ts +16 -15
  39. package/dist/api/restful/commerce/translation/index.js +19 -18
  40. package/dist/api/restful/developer/analytics/index.d.ts +23 -22
  41. package/dist/api/restful/developer/analytics/index.js +39 -38
  42. package/dist/api/restful/developer/index.d.ts +7 -7
  43. package/dist/api/restful/developer/index.js +3 -3
  44. package/dist/api/restful/developer/keyManagement/index.d.ts +25 -24
  45. package/dist/api/restful/developer/keyManagement/index.js +37 -36
  46. package/dist/api/restful/index.d.ts +70 -67
  47. package/dist/api/restful/index.js +180 -180
  48. package/dist/api/restful/postOrder/cancellation/index.d.ts +57 -57
  49. package/dist/api/restful/postOrder/cancellation/index.js +89 -88
  50. package/dist/api/restful/postOrder/case/index.d.ts +63 -63
  51. package/dist/api/restful/postOrder/case/index.js +89 -88
  52. package/dist/api/restful/postOrder/index.d.ts +11 -11
  53. package/dist/api/restful/postOrder/index.js +5 -5
  54. package/dist/api/restful/postOrder/inquiry/index.d.ts +82 -82
  55. package/dist/api/restful/postOrder/inquiry/index.js +125 -124
  56. package/dist/api/restful/postOrder/return/index.d.ts +231 -231
  57. package/dist/api/restful/postOrder/return/index.js +355 -354
  58. package/dist/api/restful/sell/account/index.d.ts +299 -298
  59. package/dist/api/restful/sell/account/index.js +461 -460
  60. package/dist/api/restful/sell/analytics/index.d.ts +42 -41
  61. package/dist/api/restful/sell/analytics/index.js +55 -54
  62. package/dist/api/restful/sell/compliance/index.d.ts +38 -37
  63. package/dist/api/restful/sell/compliance/index.js +51 -50
  64. package/dist/api/restful/sell/feed/index.d.ts +172 -171
  65. package/dist/api/restful/sell/feed/index.js +278 -277
  66. package/dist/api/restful/sell/finances/index.d.ts +79 -78
  67. package/dist/api/restful/sell/finances/index.js +103 -102
  68. package/dist/api/restful/sell/fulfillment/index.d.ts +138 -137
  69. package/dist/api/restful/sell/fulfillment/index.js +193 -192
  70. package/dist/api/restful/sell/index.d.ts +29 -29
  71. package/dist/api/restful/sell/index.js +14 -14
  72. package/dist/api/restful/sell/inventory/index.d.ts +249 -248
  73. package/dist/api/restful/sell/inventory/index.js +340 -339
  74. package/dist/api/restful/sell/listing/index.d.ts +15 -14
  75. package/dist/api/restful/sell/listing/index.js +19 -18
  76. package/dist/api/restful/sell/logistics/index.d.ts +45 -44
  77. package/dist/api/restful/sell/logistics/index.js +60 -59
  78. package/dist/api/restful/sell/marketing/index.d.ts +627 -626
  79. package/dist/api/restful/sell/marketing/index.js +863 -862
  80. package/dist/api/restful/sell/metadata/index.d.ts +78 -77
  81. package/dist/api/restful/sell/metadata/index.js +125 -124
  82. package/dist/api/restful/sell/negotiation/index.d.ts +25 -24
  83. package/dist/api/restful/sell/negotiation/index.js +33 -32
  84. package/dist/api/restful/sell/recommendation/index.d.ts +27 -26
  85. package/dist/api/restful/sell/recommendation/index.js +33 -32
  86. package/dist/api/traditional/XMLRequest.d.ts +109 -109
  87. package/dist/api/traditional/XMLRequest.js +176 -175
  88. package/dist/api/traditional/clientAlerts/index.d.ts +9 -9
  89. package/dist/api/traditional/clientAlerts/index.js +11 -11
  90. package/dist/api/traditional/clientAlerts/types.d.ts +31 -31
  91. package/dist/api/traditional/clientAlerts/types.js +32 -32
  92. package/dist/api/traditional/fields.d.ts +1948 -1948
  93. package/dist/api/traditional/fields.js +1946 -1946
  94. package/dist/api/traditional/finding/index.d.ts +12 -12
  95. package/dist/api/traditional/finding/index.js +13 -13
  96. package/dist/api/traditional/index.d.ts +17 -17
  97. package/dist/api/traditional/index.js +191 -191
  98. package/dist/api/traditional/merchandising/index.d.ts +7 -7
  99. package/dist/api/traditional/merchandising/index.js +8 -8
  100. package/dist/api/traditional/shopping/index.d.ts +11 -11
  101. package/dist/api/traditional/shopping/index.js +13 -13
  102. package/dist/api/traditional/trading/index.d.ts +142 -142
  103. package/dist/api/traditional/trading/index.js +143 -143
  104. package/dist/auth/authNAuth.d.ts +49 -49
  105. package/dist/auth/authNAuth.js +117 -116
  106. package/dist/auth/index.d.ts +17 -17
  107. package/dist/auth/index.js +25 -25
  108. package/dist/auth/oAuth2.d.ts +95 -95
  109. package/dist/auth/oAuth2.js +260 -259
  110. package/dist/eBayApi.d.ts +59 -59
  111. package/dist/eBayApi.js +105 -104
  112. package/dist/ebay-api.min.mjs +1 -1
  113. package/dist/enums/apiEnums.d.ts +49 -49
  114. package/dist/enums/apiEnums.js +51 -51
  115. package/dist/enums/index.d.ts +2 -2
  116. package/dist/enums/index.js +2 -2
  117. package/dist/enums/restfulEnums.d.ts +976 -970
  118. package/dist/enums/restfulEnums.js +1019 -1013
  119. package/dist/errors/index.d.ts +66 -66
  120. package/dist/errors/index.js +190 -189
  121. package/dist/nanoevents.d.ts +6 -6
  122. package/dist/nanoevents.js +20 -20
  123. package/dist/request.d.ts +26 -26
  124. package/dist/request.js +43 -43
  125. package/dist/types/apiTypes.d.ts +40 -40
  126. package/dist/types/apiTypes.js +1 -1
  127. package/dist/types/index.d.ts +3 -3
  128. package/dist/types/index.js +3 -3
  129. package/dist/types/restful/specs/buy_browse_v1_oas3.d.ts +1531 -0
  130. package/dist/types/restful/specs/buy_browse_v1_oas3.js +5 -0
  131. package/dist/types/restful/specs/buy_deal_v1_oas3.d.ts +434 -0
  132. package/dist/types/restful/specs/buy_deal_v1_oas3.js +5 -0
  133. package/dist/types/restful/specs/buy_feed_v1_beta_oas3.d.ts +561 -0
  134. package/dist/types/restful/specs/buy_feed_v1_beta_oas3.js +5 -0
  135. package/dist/types/restful/specs/buy_marketing_v1_beta_oas3.d.ts +288 -0
  136. package/dist/types/restful/specs/buy_marketing_v1_beta_oas3.js +5 -0
  137. package/dist/types/restful/specs/buy_marketplace_insights_v1_beta_oas3.d.ts +304 -0
  138. package/dist/types/restful/specs/buy_marketplace_insights_v1_beta_oas3.js +5 -0
  139. package/dist/types/restful/specs/buy_offer_v1_beta_oas3.d.ts +173 -0
  140. package/dist/types/restful/specs/buy_offer_v1_beta_oas3.js +5 -0
  141. package/dist/types/restful/specs/buy_order_v1_beta_oas3.d.ts +1701 -0
  142. package/dist/types/restful/specs/buy_order_v1_beta_oas3.js +5 -0
  143. package/dist/types/restful/specs/cancellation_oas3.d.ts +112 -0
  144. package/dist/types/restful/specs/cancellation_oas3.js +5 -0
  145. package/dist/types/restful/specs/case_oas3.d.ts +124 -0
  146. package/dist/types/restful/specs/case_oas3.js +5 -0
  147. package/dist/types/restful/specs/commerce_catalog_v1_beta_oas3.d.ts +758 -0
  148. package/dist/types/restful/specs/commerce_catalog_v1_beta_oas3.js +5 -0
  149. package/dist/types/restful/specs/commerce_charity_v1_oas3.d.ts +224 -0
  150. package/dist/types/restful/specs/commerce_charity_v1_oas3.js +5 -0
  151. package/dist/types/restful/specs/commerce_identity_v1_oas3.d.ts +152 -0
  152. package/dist/types/restful/specs/commerce_identity_v1_oas3.js +5 -0
  153. package/dist/types/restful/specs/commerce_notification_v1_oas3.d.ts +677 -0
  154. package/dist/types/restful/specs/commerce_notification_v1_oas3.js +5 -0
  155. package/dist/types/restful/specs/commerce_taxonomy_v1_oas3.d.ts +530 -0
  156. package/dist/types/restful/specs/commerce_taxonomy_v1_oas3.js +5 -0
  157. package/dist/types/restful/specs/commerce_translation_v1_beta_oas3.d.ts +100 -0
  158. package/dist/types/restful/specs/commerce_translation_v1_beta_oas3.js +5 -0
  159. package/dist/types/restful/specs/developer_analytics_v1_beta_oas3.d.ts +158 -0
  160. package/dist/types/restful/specs/developer_analytics_v1_beta_oas3.js +5 -0
  161. package/dist/types/restful/specs/developer_key_management_v1_oas3.d.ts +162 -0
  162. package/dist/types/restful/specs/developer_key_management_v1_oas3.js +5 -0
  163. package/dist/types/restful/specs/inquiry_oas3.d.ts +180 -0
  164. package/dist/types/restful/specs/inquiry_oas3.js +5 -0
  165. package/dist/types/restful/specs/return_oas3.d.ts +528 -0
  166. package/dist/types/restful/specs/return_oas3.js +5 -0
  167. package/dist/types/restful/specs/sell_account_v1_oas3.d.ts +2061 -0
  168. package/dist/types/restful/specs/sell_account_v1_oas3.js +5 -0
  169. package/dist/types/restful/specs/sell_analytics_v1_oas3.d.ts +340 -0
  170. package/dist/types/restful/specs/sell_analytics_v1_oas3.js +5 -0
  171. package/dist/types/restful/specs/sell_compliance_v1_oas3.d.ts +253 -0
  172. package/dist/types/restful/specs/sell_compliance_v1_oas3.js +5 -0
  173. package/dist/types/restful/specs/sell_feed_v1_oas3.d.ts +1191 -0
  174. package/dist/types/restful/specs/sell_feed_v1_oas3.js +5 -0
  175. package/dist/types/restful/specs/sell_finances_v1_oas3.d.ts +572 -0
  176. package/dist/types/restful/specs/sell_finances_v1_oas3.js +5 -0
  177. package/dist/types/restful/specs/sell_fulfillment_v1_oas3.d.ts +1386 -0
  178. package/dist/types/restful/specs/sell_fulfillment_v1_oas3.js +5 -0
  179. package/dist/types/restful/specs/sell_inventory_v1_oas3.d.ts +2175 -0
  180. package/dist/types/restful/specs/sell_inventory_v1_oas3.js +5 -0
  181. package/dist/types/restful/specs/sell_listing_v1_beta_oas3.d.ts +150 -0
  182. package/dist/types/restful/specs/sell_listing_v1_beta_oas3.js +5 -0
  183. package/dist/types/restful/specs/sell_logistics_v1_oas3.d.ts +451 -0
  184. package/dist/types/restful/specs/sell_logistics_v1_oas3.js +5 -0
  185. package/dist/types/restful/specs/sell_marketing_v1_oas3.d.ts +3728 -0
  186. package/dist/types/restful/specs/sell_marketing_v1_oas3.js +5 -0
  187. package/dist/types/restful/specs/sell_metadata_v1_oas3.d.ts +429 -0
  188. package/dist/types/restful/specs/sell_metadata_v1_oas3.js +5 -0
  189. package/dist/types/restful/specs/sell_negotiation_v1_oas3.d.ts +225 -0
  190. package/dist/types/restful/specs/sell_negotiation_v1_oas3.js +5 -0
  191. package/dist/types/restful/specs/sell_recommendation_v1_oas3.d.ts +148 -0
  192. package/dist/types/restful/specs/sell_recommendation_v1_oas3.js +5 -0
  193. package/dist/types/restfulTypes.d.ts +439 -1179
  194. package/dist/types/restfulTypes.js +1 -1
  195. package/dist/types/traditonalTypes.d.ts +35 -35
  196. package/dist/types/traditonalTypes.js +1 -1
  197. package/lib/api/apiFactory.d.ts +27 -27
  198. package/lib/api/apiFactory.js +100 -100
  199. package/lib/api/base.d.ts +10 -10
  200. package/lib/api/base.js +13 -13
  201. package/lib/api/digitalSignature.d.ts +43 -43
  202. package/lib/api/digitalSignature.js +112 -112
  203. package/lib/api/index.d.ts +13 -13
  204. package/lib/api/index.js +35 -35
  205. package/lib/api/restful/buy/browse/index.d.ts +84 -84
  206. package/lib/api/restful/buy/browse/index.js +137 -141
  207. package/lib/api/restful/buy/deal/index.d.ts +56 -55
  208. package/lib/api/restful/buy/deal/index.js +79 -79
  209. package/lib/api/restful/buy/feed/index.d.ts +44 -43
  210. package/lib/api/restful/buy/feed/index.js +84 -84
  211. package/lib/api/restful/buy/index.d.ts +17 -17
  212. package/lib/api/restful/buy/index.js +20 -20
  213. package/lib/api/restful/buy/marketing/index.d.ts +28 -27
  214. package/lib/api/restful/buy/marketing/index.js +50 -50
  215. package/lib/api/restful/buy/marketplaceInsights/index.d.ts +29 -28
  216. package/lib/api/restful/buy/marketplaceInsights/index.js +50 -50
  217. package/lib/api/restful/buy/offer/index.d.ts +24 -23
  218. package/lib/api/restful/buy/offer/index.js +36 -36
  219. package/lib/api/restful/buy/order/index.d.ts +265 -264
  220. package/lib/api/restful/buy/order/index.js +368 -368
  221. package/lib/api/restful/commerce/catalog/index.d.ts +74 -73
  222. package/lib/api/restful/commerce/catalog/index.js +105 -107
  223. package/lib/api/restful/commerce/charity/index.d.ts +35 -34
  224. package/lib/api/restful/commerce/charity/index.js +55 -55
  225. package/lib/api/restful/commerce/identity/index.d.ts +15 -14
  226. package/lib/api/restful/commerce/identity/index.js +26 -26
  227. package/lib/api/restful/commerce/index.d.ts +15 -15
  228. package/lib/api/restful/commerce/index.js +18 -18
  229. package/lib/api/restful/commerce/notification/index.d.ts +118 -117
  230. package/lib/api/restful/commerce/notification/index.js +186 -186
  231. package/lib/api/restful/commerce/taxonomy/index.d.ts +79 -78
  232. package/lib/api/restful/commerce/taxonomy/index.js +134 -134
  233. package/lib/api/restful/commerce/translation/index.d.ts +16 -15
  234. package/lib/api/restful/commerce/translation/index.js +24 -24
  235. package/lib/api/restful/developer/analytics/index.d.ts +23 -22
  236. package/lib/api/restful/developer/analytics/index.js +44 -44
  237. package/lib/api/restful/developer/index.d.ts +7 -7
  238. package/lib/api/restful/developer/index.js +10 -10
  239. package/lib/api/restful/developer/keyManagement/index.d.ts +25 -24
  240. package/lib/api/restful/developer/keyManagement/index.js +42 -42
  241. package/lib/api/restful/index.d.ts +70 -67
  242. package/lib/api/restful/index.js +187 -187
  243. package/lib/api/restful/postOrder/cancellation/index.d.ts +57 -57
  244. package/lib/api/restful/postOrder/cancellation/index.js +94 -94
  245. package/lib/api/restful/postOrder/case/index.d.ts +63 -63
  246. package/lib/api/restful/postOrder/case/index.js +94 -94
  247. package/lib/api/restful/postOrder/index.d.ts +11 -11
  248. package/lib/api/restful/postOrder/index.js +14 -14
  249. package/lib/api/restful/postOrder/inquiry/index.d.ts +82 -82
  250. package/lib/api/restful/postOrder/inquiry/index.js +130 -130
  251. package/lib/api/restful/postOrder/return/index.d.ts +231 -231
  252. package/lib/api/restful/postOrder/return/index.js +360 -360
  253. package/lib/api/restful/sell/account/index.d.ts +299 -298
  254. package/lib/api/restful/sell/account/index.js +466 -466
  255. package/lib/api/restful/sell/analytics/index.d.ts +42 -41
  256. package/lib/api/restful/sell/analytics/index.js +60 -60
  257. package/lib/api/restful/sell/compliance/index.d.ts +38 -37
  258. package/lib/api/restful/sell/compliance/index.js +56 -56
  259. package/lib/api/restful/sell/feed/index.d.ts +172 -171
  260. package/lib/api/restful/sell/feed/index.js +283 -283
  261. package/lib/api/restful/sell/finances/index.d.ts +79 -78
  262. package/lib/api/restful/sell/finances/index.js +108 -108
  263. package/lib/api/restful/sell/fulfillment/index.d.ts +138 -137
  264. package/lib/api/restful/sell/fulfillment/index.js +198 -198
  265. package/lib/api/restful/sell/index.d.ts +29 -29
  266. package/lib/api/restful/sell/index.js +32 -32
  267. package/lib/api/restful/sell/inventory/index.d.ts +249 -248
  268. package/lib/api/restful/sell/inventory/index.js +345 -345
  269. package/lib/api/restful/sell/listing/index.d.ts +15 -14
  270. package/lib/api/restful/sell/listing/index.js +24 -24
  271. package/lib/api/restful/sell/logistics/index.d.ts +45 -44
  272. package/lib/api/restful/sell/logistics/index.js +65 -65
  273. package/lib/api/restful/sell/marketing/index.d.ts +627 -626
  274. package/lib/api/restful/sell/marketing/index.js +868 -868
  275. package/lib/api/restful/sell/metadata/index.d.ts +78 -77
  276. package/lib/api/restful/sell/metadata/index.js +130 -130
  277. package/lib/api/restful/sell/negotiation/index.d.ts +25 -24
  278. package/lib/api/restful/sell/negotiation/index.js +38 -38
  279. package/lib/api/restful/sell/recommendation/index.d.ts +27 -26
  280. package/lib/api/restful/sell/recommendation/index.js +38 -38
  281. package/lib/api/traditional/XMLRequest.d.ts +109 -109
  282. package/lib/api/traditional/XMLRequest.js +182 -182
  283. package/lib/api/traditional/clientAlerts/index.d.ts +9 -9
  284. package/lib/api/traditional/clientAlerts/index.js +14 -14
  285. package/lib/api/traditional/clientAlerts/types.d.ts +31 -31
  286. package/lib/api/traditional/clientAlerts/types.js +34 -35
  287. package/lib/api/traditional/fields.d.ts +1948 -1948
  288. package/lib/api/traditional/fields.js +1948 -1948
  289. package/lib/api/traditional/finding/index.d.ts +12 -12
  290. package/lib/api/traditional/finding/index.js +15 -15
  291. package/lib/api/traditional/index.d.ts +17 -17
  292. package/lib/api/traditional/index.js +220 -220
  293. package/lib/api/traditional/merchandising/index.d.ts +7 -7
  294. package/lib/api/traditional/merchandising/index.js +10 -10
  295. package/lib/api/traditional/shopping/index.d.ts +11 -11
  296. package/lib/api/traditional/shopping/index.js +15 -15
  297. package/lib/api/traditional/trading/index.d.ts +142 -142
  298. package/lib/api/traditional/trading/index.js +145 -145
  299. package/lib/auth/authNAuth.d.ts +49 -49
  300. package/lib/auth/authNAuth.js +122 -122
  301. package/lib/auth/index.d.ts +17 -17
  302. package/lib/auth/index.js +31 -31
  303. package/lib/auth/oAuth2.d.ts +95 -95
  304. package/lib/auth/oAuth2.js +265 -265
  305. package/lib/eBayApi.d.ts +59 -59
  306. package/lib/eBayApi.js +141 -141
  307. package/lib/ebay-api.min.js +1 -1
  308. package/lib/enums/apiEnums.d.ts +49 -49
  309. package/lib/enums/apiEnums.js +54 -54
  310. package/lib/enums/index.d.ts +2 -2
  311. package/lib/enums/index.js +18 -18
  312. package/lib/enums/restfulEnums.d.ts +976 -970
  313. package/lib/enums/restfulEnums.js +1021 -1016
  314. package/lib/errors/index.d.ts +66 -66
  315. package/lib/errors/index.js +213 -212
  316. package/lib/index.d.ts +2 -2
  317. package/lib/index.js +6 -6
  318. package/lib/nanoevents.d.ts +6 -6
  319. package/lib/nanoevents.js +24 -24
  320. package/lib/request.d.ts +26 -26
  321. package/lib/request.js +50 -50
  322. package/lib/types/apiTypes.d.ts +40 -40
  323. package/lib/types/apiTypes.js +2 -2
  324. package/lib/types/index.d.ts +3 -3
  325. package/lib/types/index.js +19 -19
  326. package/lib/types/restful/specs/buy_browse_v1_oas3.d.ts +1531 -0
  327. package/lib/types/restful/specs/buy_browse_v1_oas3.js +6 -0
  328. package/lib/types/restful/specs/buy_deal_v1_oas3.d.ts +434 -0
  329. package/lib/types/restful/specs/buy_deal_v1_oas3.js +6 -0
  330. package/lib/types/restful/specs/buy_feed_v1_beta_oas3.d.ts +561 -0
  331. package/lib/types/restful/specs/buy_feed_v1_beta_oas3.js +6 -0
  332. package/lib/types/restful/specs/buy_marketing_v1_beta_oas3.d.ts +288 -0
  333. package/lib/types/restful/specs/buy_marketing_v1_beta_oas3.js +6 -0
  334. package/lib/types/restful/specs/buy_marketplace_insights_v1_beta_oas3.d.ts +304 -0
  335. package/lib/types/restful/specs/buy_marketplace_insights_v1_beta_oas3.js +6 -0
  336. package/lib/types/restful/specs/buy_offer_v1_beta_oas3.d.ts +173 -0
  337. package/lib/types/restful/specs/buy_offer_v1_beta_oas3.js +6 -0
  338. package/lib/types/restful/specs/buy_order_v1_beta_oas3.d.ts +1701 -0
  339. package/lib/types/restful/specs/buy_order_v1_beta_oas3.js +6 -0
  340. package/lib/types/restful/specs/cancellation_oas3.d.ts +112 -0
  341. package/lib/types/restful/specs/cancellation_oas3.js +6 -0
  342. package/lib/types/restful/specs/case_oas3.d.ts +124 -0
  343. package/lib/types/restful/specs/case_oas3.js +6 -0
  344. package/lib/types/restful/specs/commerce_catalog_v1_beta_oas3.d.ts +758 -0
  345. package/lib/types/restful/specs/commerce_catalog_v1_beta_oas3.js +6 -0
  346. package/lib/types/restful/specs/commerce_charity_v1_oas3.d.ts +224 -0
  347. package/lib/types/restful/specs/commerce_charity_v1_oas3.js +6 -0
  348. package/lib/types/restful/specs/commerce_identity_v1_oas3.d.ts +152 -0
  349. package/lib/types/restful/specs/commerce_identity_v1_oas3.js +6 -0
  350. package/lib/types/restful/specs/commerce_notification_v1_oas3.d.ts +677 -0
  351. package/lib/types/restful/specs/commerce_notification_v1_oas3.js +6 -0
  352. package/lib/types/restful/specs/commerce_taxonomy_v1_oas3.d.ts +530 -0
  353. package/lib/types/restful/specs/commerce_taxonomy_v1_oas3.js +6 -0
  354. package/lib/types/restful/specs/commerce_translation_v1_beta_oas3.d.ts +100 -0
  355. package/lib/types/restful/specs/commerce_translation_v1_beta_oas3.js +6 -0
  356. package/lib/types/restful/specs/developer_analytics_v1_beta_oas3.d.ts +158 -0
  357. package/lib/types/restful/specs/developer_analytics_v1_beta_oas3.js +6 -0
  358. package/lib/types/restful/specs/developer_key_management_v1_oas3.d.ts +162 -0
  359. package/lib/types/restful/specs/developer_key_management_v1_oas3.js +6 -0
  360. package/lib/types/restful/specs/inquiry_oas3.d.ts +180 -0
  361. package/lib/types/restful/specs/inquiry_oas3.js +6 -0
  362. package/lib/types/restful/specs/return_oas3.d.ts +528 -0
  363. package/lib/types/restful/specs/return_oas3.js +6 -0
  364. package/lib/types/restful/specs/sell_account_v1_oas3.d.ts +2061 -0
  365. package/lib/types/restful/specs/sell_account_v1_oas3.js +6 -0
  366. package/lib/types/restful/specs/sell_analytics_v1_oas3.d.ts +340 -0
  367. package/lib/types/restful/specs/sell_analytics_v1_oas3.js +6 -0
  368. package/lib/types/restful/specs/sell_compliance_v1_oas3.d.ts +253 -0
  369. package/lib/types/restful/specs/sell_compliance_v1_oas3.js +6 -0
  370. package/lib/types/restful/specs/sell_feed_v1_oas3.d.ts +1191 -0
  371. package/lib/types/restful/specs/sell_feed_v1_oas3.js +6 -0
  372. package/lib/types/restful/specs/sell_finances_v1_oas3.d.ts +572 -0
  373. package/lib/types/restful/specs/sell_finances_v1_oas3.js +6 -0
  374. package/lib/types/restful/specs/sell_fulfillment_v1_oas3.d.ts +1386 -0
  375. package/lib/types/restful/specs/sell_fulfillment_v1_oas3.js +6 -0
  376. package/lib/types/restful/specs/sell_inventory_v1_oas3.d.ts +2175 -0
  377. package/lib/types/restful/specs/sell_inventory_v1_oas3.js +6 -0
  378. package/lib/types/restful/specs/sell_listing_v1_beta_oas3.d.ts +150 -0
  379. package/lib/types/restful/specs/sell_listing_v1_beta_oas3.js +6 -0
  380. package/lib/types/restful/specs/sell_logistics_v1_oas3.d.ts +451 -0
  381. package/lib/types/restful/specs/sell_logistics_v1_oas3.js +6 -0
  382. package/lib/types/restful/specs/sell_marketing_v1_oas3.d.ts +3728 -0
  383. package/lib/types/restful/specs/sell_marketing_v1_oas3.js +6 -0
  384. package/lib/types/restful/specs/sell_metadata_v1_oas3.d.ts +429 -0
  385. package/lib/types/restful/specs/sell_metadata_v1_oas3.js +6 -0
  386. package/lib/types/restful/specs/sell_negotiation_v1_oas3.d.ts +225 -0
  387. package/lib/types/restful/specs/sell_negotiation_v1_oas3.js +6 -0
  388. package/lib/types/restful/specs/sell_recommendation_v1_oas3.d.ts +148 -0
  389. package/lib/types/restful/specs/sell_recommendation_v1_oas3.js +6 -0
  390. package/lib/types/restfulTypes.d.ts +439 -1179
  391. package/lib/types/restfulTypes.js +2 -2
  392. package/lib/types/traditonalTypes.d.ts +35 -35
  393. package/lib/types/traditonalTypes.js +2 -2
  394. package/package.json +6 -4
@@ -1,868 +1,868 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
4
- };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- const index_js_1 = __importDefault(require("../../index.js"));
7
- /**
8
- * <p>The <i>Marketing API </i> offers two platforms that sellers can use to promote and advertise their products:
9
- * </p> <ul><li><b>Promoted Listings</b> is an eBay ad service that lets sellers set up <i>ad campaigns </i>
10
- * for the products they want to promote. eBay displays the ads in search results and in other
11
- * marketing modules as <b>SPONSORED</b> listings.
12
- */
13
- class Marketing extends index_js_1.default {
14
- get basePath() {
15
- return '/sell/marketing/v1';
16
- }
17
- /**
18
- * This method creates an ad for each inventory reference ID specified in the request and associates the newly
19
- * created ads with the specified campaign.
20
- *
21
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created.
22
- * @param body This type defines the fields for the bulkCreateAdsByInventoryReference request.
23
- */
24
- bulkCreateAdsByInventoryReference(campaignId, body) {
25
- campaignId = encodeURIComponent(campaignId);
26
- return this.post(`/ad_campaign/${campaignId}/bulk_create_ads_by_inventory_reference`, body);
27
- }
28
- /**
29
- * This method creates an ad for each listing ID specified in the request and associates the newly created ads with
30
- * the specified campaign.
31
- *
32
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
33
- * a seller's campaign IDs by calling getCampaigns.
34
- * @param body The container for the bulk request to create ads for eBay listing IDs. eBay listing IDs are
35
- * generated when the listing is created on eBay.
36
- */
37
- bulkCreateAdsByListingId(campaignId, body) {
38
- campaignId = encodeURIComponent(campaignId);
39
- return this.post(`/ad_campaign/${campaignId}/bulk_create_ads_by_listing_id`, body);
40
- }
41
- /**
42
- * This method deletes a set of ads, as specified by a list of inventory reference IDs, from the specified
43
- * campaign.
44
- *
45
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
46
- * a seller's campaign IDs by calling getCampaigns.
47
- * @param body This type defines the fields for a bulkDeleteAdsByInventoryReference request.
48
- */
49
- bulkDeleteAdsByInventoryReference(campaignId, body) {
50
- campaignId = encodeURIComponent(campaignId);
51
- return this.post(`/ad_campaign/${campaignId}/bulk_delete_ads_by_inventory_reference`, body);
52
- }
53
- /**
54
- * This method deletes a set of ads, as specified by a list of listing IDs, from the specified campaign.
55
- *
56
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
57
- * a seller's campaign IDs by calling getCampaigns.
58
- * @param body This type defines the fields for the bulkDeleteAdsByListingId request.
59
- */
60
- bulkDeleteAdsByListingId(campaignId, body) {
61
- campaignId = encodeURIComponent(campaignId);
62
- return this.post(`/ad_campaign/${campaignId}/bulk_delete_ads_by_listing_id`, body);
63
- }
64
- /**
65
- * This method replaces an ad bid based on a list of inventory references IDs associated with the specified
66
- * campaign.
67
- *
68
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created.
69
- * @param body This type defines the fields for the BulkCreateAdsByInventoryReference request.
70
- */
71
- bulkUpdateAdsBidByInventoryReference(campaignId, body) {
72
- campaignId = encodeURIComponent(campaignId);
73
- return this.post(`/ad_campaign/${campaignId}/bulk_update_ads_bid_by_inventory_reference`, body);
74
- }
75
- /**
76
- * This method replaces an ad bid based on a supplied list of listing IDs that are associated with the specified
77
- * campaign.
78
- *
79
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
80
- * a seller's campaign IDs by calling getCampaigns.
81
- * @param body Container for the bulk request to update ads.
82
- */
83
- bulkUpdateAdsBidByListingId(campaignId, body) {
84
- campaignId = encodeURIComponent(campaignId);
85
- return this.post(`/ad_campaign/${campaignId}/bulk_update_ads_bid_by_listing_id`, body);
86
- }
87
- /**
88
- * This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
89
- *
90
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
91
- * a seller's campaign IDs by calling getCampaigns.
92
- * @param body The bulk request to update the ads.
93
- */
94
- bulkUpdateAdsStatus(campaignId, body) {
95
- campaignId = encodeURIComponent(campaignId);
96
- return this.post(`/ad_campaign/${campaignId}/bulk_update_ads_status`, body);
97
- }
98
- /**
99
- * This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
100
- *
101
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
102
- * a seller's campaign IDs by calling getCampaigns.
103
- * @param body The bulk request to update ads.
104
- */
105
- bulkUpdateAdsStatusByListingId(campaignId, body) {
106
- campaignId = encodeURIComponent(campaignId);
107
- return this.post(`/ad_campaign/${campaignId}/bulk_update_ads_status_by_listing_id`, body);
108
- }
109
- /**
110
- * This method retrieves all the ads for the specified campaign.
111
- *
112
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
113
- * a seller's campaign IDs by calling getCampaigns.
114
- * @param limit Specifies the maximum number of ads to return on a page in the paginated response. Default: 10
115
- * Maximum: 500
116
- * @param listingIds A comma separated list of eBay listing IDs. The response includes only active ads (ads
117
- * associated with a RUNNING campaign).
118
- * @param offset Specifies the number of ads to skip in the result set before returning the first ad in the
119
- * paginated response.
120
- */
121
- getAds(campaignId, { limit, listingIds, offset } = {}) {
122
- campaignId = encodeURIComponent(campaignId);
123
- return this.get(`/ad_campaign/${campaignId}/ad`, {
124
- params: {
125
- limit,
126
- listing_ids: listingIds,
127
- offset
128
- }
129
- });
130
- }
131
- /**
132
- * This method creates an ad for the specified listing ID, sets the bid percentage for that specific item, and
133
- * associates the ad with the specified campaign.
134
- *
135
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
136
- * a seller's campaign IDs by calling getCampaigns.
137
- * @param body This type defines the fields for the createAd request.
138
- */
139
- createAdByListingId(campaignId, body) {
140
- campaignId = encodeURIComponent(campaignId);
141
- return this.post(`/ad_campaign/${campaignId}/ad`, body);
142
- }
143
- /**
144
- * This method creates an ad for the specified inventory reference ID, sets the bid percentage for that specific
145
- * item, and associates the ad with the specified campaign.
146
- *
147
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
148
- * a seller's campaign IDs by calling getCampaigns.
149
- * @param body This type defines the fields for the createAdsByInventoryReference request.
150
- */
151
- createAdsByInventoryReference(campaignId, body) {
152
- campaignId = encodeURIComponent(campaignId);
153
- return this.post(`/ad_campaign/${campaignId}/create_ads_by_inventory_reference`, body);
154
- }
155
- /**
156
- * This method retrieves the specified ad from the specified campaign.
157
- *
158
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
159
- * a seller's campaign IDs by calling getCampaigns.
160
- * @param adId Identifier of an ad. This ID was generated when the ad was created.
161
- */
162
- getAd(campaignId, adId) {
163
- campaignId = encodeURIComponent(campaignId);
164
- adId = encodeURIComponent(adId);
165
- return this.get(`/ad_campaign/${campaignId}/ad/${adId}`);
166
- }
167
- /**
168
- * This method retrieves the specified ad from the specified campaign.
169
- *
170
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created.
171
- * @param adId Identifier of an ad. This ID was generated when the ad was created.
172
- */
173
- deleteAd(campaignId, adId) {
174
- campaignId = encodeURIComponent(campaignId);
175
- adId = encodeURIComponent(adId);
176
- return this.delete(`/ad_campaign/${campaignId}/ad/${adId}`);
177
- }
178
- /**
179
- * This method deletes ads using a list of seller inventory reference IDs that are associated with the specified
180
- * campaign ID.
181
- *
182
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
183
- * a seller's campaign IDs by calling getCampaigns.
184
- */
185
- deleteAdsByInventoryReference(campaignId) {
186
- campaignId = encodeURIComponent(campaignId);
187
- return this.post(`/ad_campaign/${campaignId}/delete_ads_by_inventory_reference`);
188
- }
189
- /**
190
- * This method retrieves ads from the specified campaign using the seller's inventory reference ID and inventory
191
- * reference type.
192
- *
193
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
194
- * a seller's campaign IDs by calling getCampaigns.
195
- * @param inventoryReferenceId The inventory reference ID associated with the ad you want returned.
196
- * @param inventoryReferenceType The type of the inventory reference ID. Set this value to either INVENTORY_ITEM (a
197
- * single listing) or INVENTORY_ITEM_GROUP (a multi-variation listing).
198
- */
199
- getAdsByInventoryReference(campaignId, inventoryReferenceId, inventoryReferenceType) {
200
- campaignId = encodeURIComponent(campaignId);
201
- return this.get(`/ad_campaign/${campaignId}/get_ads_by_inventory_reference`, {
202
- params: {
203
- inventory_reference_id: inventoryReferenceId,
204
- inventory_reference_type: inventoryReferenceType
205
- }
206
- });
207
- }
208
- /**
209
- * This method updates the bid for the specified ad in the specified campaign. In the request, supply the
210
- * campaign_id and ad_id as a URI parameters.
211
- *
212
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
213
- * a seller's campaign IDs by calling getCampaigns.
214
- * @param adId A unique eBay-assigned ID for an ad that's generated when an ad is created.
215
- * @param body This type defines the fields for the updateBid request.
216
- */
217
- updateBid(campaignId, adId, body) {
218
- campaignId = encodeURIComponent(campaignId);
219
- adId = encodeURIComponent(adId);
220
- return this.post(`/ad_campaign/${campaignId}/ad/${adId}/update_bid`, body);
221
- }
222
- /**
223
- *
224
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
225
- * a seller's campaign IDs by calling getCampaigns.
226
- * @param adGroupStatus A comma-separated list of ad group statuses.
227
- * @param limit The number of results, from the current result set, to be returned in a single page.
228
- * @param offset The number of results that will be skipped in the result set.
229
- */
230
- getAdGroups(campaignId, { adGroupStatus, limit, offset } = {}) {
231
- campaignId = encodeURIComponent(campaignId);
232
- return this.get(`/ad_campaign/${campaignId}/ad_group`, {
233
- params: {
234
- ad_group_status: adGroupStatus,
235
- limit,
236
- offset
237
- }
238
- });
239
- }
240
- /**
241
- *
242
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
243
- * a seller's campaign IDs by calling getCampaigns.
244
- * @param body This type defines the fields for the <b>createAdGroup</b> request.
245
- */
246
- createAdGroup(campaignId, body) {
247
- campaignId = encodeURIComponent(campaignId);
248
- return this.post(`/ad_campaign/${campaignId}/ad_group`, body);
249
- }
250
- /**
251
- *
252
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
253
- * a seller's campaign IDs by calling getCampaigns.
254
- * @param adGroupId The ID of the ad group that shall be retrieved.
255
- */
256
- getAdGroup(campaignId, adGroupId) {
257
- adGroupId = encodeURIComponent(adGroupId);
258
- campaignId = encodeURIComponent(campaignId);
259
- return this.get(`/ad_campaign/${campaignId}/ad_group/${adGroupId}`);
260
- }
261
- /**
262
- *
263
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
264
- * a seller's campaign IDs by calling getCampaigns.
265
- * @param adGroupId The ID of the ad group that shall be retrieved.
266
- * @param body This type defines the fields for the <b>UpdateAdGroup</b> request.
267
- */
268
- updateAdGroup(campaignId, adGroupId, body) {
269
- adGroupId = encodeURIComponent(adGroupId);
270
- campaignId = encodeURIComponent(campaignId);
271
- return this.put(`/ad_campaign/${campaignId}/ad_group/${adGroupId}`, body);
272
- }
273
- /**
274
- *
275
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
276
- * a seller's campaign IDs by calling getCampaigns.
277
- * @param adGroupId The ID of the ad group that shall be retrieved.
278
- * @param body The data requested to retrieve the suggested bids.
279
- */
280
- suggestBids(campaignId, adGroupId, body) {
281
- adGroupId = encodeURIComponent(adGroupId);
282
- campaignId = encodeURIComponent(campaignId);
283
- return this.post(`/ad_campaign/${campaignId}/ad_group/${adGroupId}/suggest_bids`, body);
284
- }
285
- /**
286
- *
287
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
288
- * a seller's campaign IDs by calling getCampaigns.
289
- * @param adGroupId The ID of the ad group that shall be retrieved.
290
- * @param body The required data to retrieve suggested keywords.
291
- */
292
- suggestKeywords(campaignId, adGroupId, body) {
293
- adGroupId = encodeURIComponent(adGroupId);
294
- campaignId = encodeURIComponent(campaignId);
295
- return this.post(`/ad_campaign/${campaignId}/ad_group/${adGroupId}/suggest_keywords`, body);
296
- }
297
- /**
298
- * This method clones (makes a copy of) the specified campaign.
299
- *
300
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
301
- * a seller's campaign IDs by calling getCampaigns.
302
- * @param body This type defines the fields for a clone campaign request.
303
- */
304
- cloneCampaign(campaignId, body) {
305
- campaignId = encodeURIComponent(campaignId);
306
- return this.post(`/ad_campaign/${campaignId}/clone`, body);
307
- }
308
- /**
309
- * This method retrieves the details for all the campaigns of a seller, including the campaign's the selection
310
- * rules.
311
- *
312
- * @param campaignName Specifies the campaign name. The results are filtered to include only the campaign by the
313
- * specified name.
314
- * @param campaignStatus Specifies the campaign status. The results are filtered to include only campaigns that are
315
- * in the specified states.
316
- * @param endDateRange Specifies the range of a campaign's end date. The results are filtered to include only
317
- * campaigns with an end date that is within specified range.
318
- * @param limit Specifies the maximum number of campaigns to return on a page in the paginated response. Default:
319
- * 10 Maximum: 500
320
- * @param offset Specifies the number of campaigns to skip in the result set before returning the first report in
321
- * the paginated response.
322
- * @param startDateRange Specifies the range of a campaign's start date in which to filter the results.
323
- */
324
- getCampaigns({ campaignName, campaignStatus, endDateRange, limit, offset, startDateRange } = {}) {
325
- return this.get(`/ad_campaign`, {
326
- params: {
327
- campaign_name: campaignName,
328
- campaign_status: campaignStatus,
329
- end_date_range: endDateRange,
330
- limit,
331
- offset,
332
- start_date_range: startDateRange
333
- }
334
- });
335
- }
336
- /**
337
- * This method retrieves the details of a single campaign, as specified with the campaign_id query parameter.
338
- *
339
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
340
- * a seller's campaign IDs by calling getCampaigns.
341
- */
342
- getCampaign(campaignId) {
343
- campaignId = encodeURIComponent(campaignId);
344
- return this.get(`/ad_campaign/${campaignId}`);
345
- }
346
- /**
347
- * This method creates a Promoted Listings ad campaign.
348
- *
349
- * @param body his type defines the fields for the create campaign request.
350
- */
351
- createCampaign(body) {
352
- return this.post(`/ad_campaign`, body);
353
- }
354
- /**
355
- * This method deletes the campaign specified by the campaign_id query parameter.
356
- *
357
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
358
- * a seller's campaign IDs by calling getCampaigns.
359
- */
360
- deleteCampaign(campaignId) {
361
- campaignId = encodeURIComponent(campaignId);
362
- return this.delete(`/ad_campaign/${campaignId}`);
363
- }
364
- /**
365
- * This method ends an active (RUNNINGM) or paused campaign. Specify the campaign you want to end by supplying its
366
- * campaign ID in a query parameter.
367
- *
368
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
369
- * a seller's campaign IDs by calling getCampaigns.
370
- */
371
- endCampaign(campaignId) {
372
- campaignId = encodeURIComponent(campaignId);
373
- return this.post(`/ad_campaign/${campaignId}/end`);
374
- }
375
- /**
376
- * This method retrieves the campaign containing the listing that is specified using either an eBay listing ID or
377
- * an inventory reference ID and inventory reference type.
378
- *
379
- * @param inventoryReferenceId The seller's inventory reference ID of the listing to be used to find the campaign
380
- * in which it is associated.
381
- * @param inventoryReferenceType The type of the seller's inventory reference ID, which is a listing or group of
382
- * items.
383
- * @param listingId Identifier of the eBay listing associated with the ad.
384
- */
385
- findCampaignByAdReference({ inventoryReferenceId, inventoryReferenceType, listingId } = {}) {
386
- return this.get(`/ad_campaign/find_campaign_by_ad_reference`, {
387
- params: {
388
- inventory_reference_id: inventoryReferenceId,
389
- inventory_reference_type: inventoryReferenceType,
390
- listing_id: listingId
391
- }
392
- });
393
- }
394
- /**
395
- * This method retrieves the details of a single campaign, as specified with the campaign_name query parameter.
396
- *
397
- * @param campaignName Name of the campaign.
398
- */
399
- getCampaignByName(campaignName) {
400
- return this.get(`/ad_campaign/get_campaign_by_name`, {
401
- params: {
402
- campaign_name: campaignName
403
- }
404
- });
405
- }
406
- /**
407
- * This method pauses an active (RUNNING) campaign. You can restarted by calling resumeCampaign, as long as the
408
- * campaign's end date is in the future..
409
- *
410
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
411
- * a seller's campaign IDs by calling getCampaigns.
412
- */
413
- pauseCampaign(campaignId) {
414
- campaignId = encodeURIComponent(campaignId);
415
- return this.post(`/ad_campaign/${campaignId}/pause`);
416
- }
417
- /**
418
- * This method resumes a paused campaign, as long as it's end date is in the future.
419
- *
420
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
421
- * a seller's campaign IDs by calling getCampaigns.
422
- */
423
- resumeCampaign(campaignId) {
424
- campaignId = encodeURIComponent(campaignId);
425
- return this.post(`/ad_campaign/${campaignId}/resume`);
426
- }
427
- /**
428
- *
429
- * @param campaignId A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.
430
- * @param categoryIds Specifies the category ID that is used to limit the results.
431
- * @param limit Specifies the maximum number of campaigns to return on a page in the paginated response.
432
- * @param offset Specifies the number of campaigns to skip in the result set before returning the first report in the paginated response.
433
- */
434
- suggestItems(campaignId, { categoryIds, limit, offset } = {}) {
435
- campaignId = encodeURIComponent(campaignId);
436
- return this.get(`/ad_campaign/${campaignId}/suggest_items`, {
437
- params: {
438
- category_ids: categoryIds,
439
- limit,
440
- offset
441
- }
442
- });
443
- }
444
- /**
445
- *
446
- * @param campaignId A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.
447
- * @param body This type defines the request fields for the ad rate strategy that shall be updated.
448
- */
449
- updateAdRateStrategy(campaignId, body) {
450
- campaignId = encodeURIComponent(campaignId);
451
- return this.post(`/ad_campaign/${campaignId}/update_ad_rate_strategy`, body);
452
- }
453
- /**
454
- *
455
- * @param campaignId A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.
456
- * @param body This type defines the request fields for the budget details that shall be updated.
457
- */
458
- updateCampaignBudget(campaignId, body) {
459
- campaignId = encodeURIComponent(campaignId);
460
- return this.post(`/ad_campaign/${campaignId}/update_campaign_budget`, body);
461
- }
462
- /**
463
- * This method replaces the name and the start and end dates of a campaign.
464
- *
465
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
466
- * a seller's campaign IDs by calling getCampaigns.
467
- * @param body This type defines the fields to updated the campaign name and start and end dates.
468
- */
469
- updateCampaignIdentification(campaignId, body) {
470
- campaignId = encodeURIComponent(campaignId);
471
- return this.post(`/ad_campaign/${campaignId}/update_campaign_identification`, body);
472
- }
473
- /**
474
- *
475
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
476
- * a seller's campaign IDs by calling getCampaigns.
477
- * @param body A type that defines the fields for the bulk request to create keywords.
478
- */
479
- bulkCreateKeyword(campaignId, body) {
480
- campaignId = encodeURIComponent(campaignId);
481
- return this.post(`/ad_campaign/${campaignId}/bulk_create_keyword`, body);
482
- }
483
- /**
484
- *
485
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
486
- * a seller's campaign IDs by calling getCampaigns.
487
- * @param body A type that defines the fields for the bulk request to update keywords.
488
- */
489
- bulkUpdateKeyword(campaignId, body) {
490
- campaignId = encodeURIComponent(campaignId);
491
- return this.post(`/ad_campaign/${campaignId}/bulk_update_keyword`, body);
492
- }
493
- /**
494
- *
495
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
496
- * a seller's campaign IDs by calling getCampaigns.
497
- * @param adGroupIds A comma-separated list of ad group IDs.
498
- * @param keywordStatus A comma-separated list of keyword statuses.
499
- * @param limit Specifies the maximum number of results to return on a page in the paginated response.
500
- * @param offset Specifies the number of results to skip in the result set before returning the first report in the paginated response.
501
- */
502
- getKeywords(campaignId, { adGroupIds, keywordStatus, limit, offset } = {}) {
503
- campaignId = encodeURIComponent(campaignId);
504
- return this.get(`/ad_campaign/${campaignId}/keyword`, {
505
- params: {
506
- ad_group_ids: adGroupIds,
507
- keyword_status: keywordStatus,
508
- limit,
509
- offset
510
- }
511
- });
512
- }
513
- /**
514
- *
515
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
516
- * a seller's campaign IDs by calling getCampaigns.
517
- * @param body A type that defines the fields for the request to create a keyword.
518
- */
519
- createKeyword(campaignId, body) {
520
- campaignId = encodeURIComponent(campaignId);
521
- return this.post(`/ad_campaign/${campaignId}/keyword`, body);
522
- }
523
- /**
524
- *
525
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
526
- * a seller's campaign IDs by calling getCampaigns.
527
- * @param keywordId This path parameter is used to identify the keyword to retrieve.
528
- */
529
- getKeyword(campaignId, keywordId) {
530
- campaignId = encodeURIComponent(campaignId);
531
- keywordId = encodeURIComponent(keywordId);
532
- return this.get(`/ad_campaign/${campaignId}/keyword/${keywordId}`);
533
- }
534
- /**
535
- *
536
- * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
537
- * a seller's campaign IDs by calling getCampaigns.
538
- * @param keywordId This path parameter is used to identify the keyword to retrieve.
539
- * @param body A type that defines the fields for the request to update a keyword.
540
- */
541
- updateKeyword(campaignId, keywordId, body) {
542
- campaignId = encodeURIComponent(campaignId);
543
- keywordId = encodeURIComponent(keywordId);
544
- return this.put(`/ad_campaign/${campaignId}/keyword/${keywordId}`, body);
545
- }
546
- /**
547
- *
548
- * @param body A type that defines the fields for the bulk request to create negative keywords.
549
- */
550
- bulkCreateNegativeKeyword(body) {
551
- return this.post(`/bulk_create_negative_keyword`, body);
552
- }
553
- /**
554
- *
555
- * @param body A type that defines the fields for the bulk request to create negative keywords.
556
- */
557
- bulkUpdateNegativeKeyword(body) {
558
- return this.post(`/bulk_update_negative_keyword`, body);
559
- }
560
- /**
561
- *
562
- * @param adGroupIds A comma-separated list of ad group IDs.
563
- * @param campaignIds A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.
564
- * @param limit The number of results, from the current result set, to be returned in a single page.
565
- * @param negativeKeywordStatus A comma-separated list of negative keyword statuses.
566
- * @param offset The number of results that will be skipped in the result set.
567
- */
568
- getNegativeKeywords({ adGroupIds, campaignIds, limit, negativeKeywordStatus, offset } = {}) {
569
- return this.get(`/negative_keyword`, {
570
- params: {
571
- ad_group_ids: adGroupIds,
572
- campaign_ids: campaignIds, limit,
573
- negative_keyword_status: negativeKeywordStatus, offset
574
- }
575
- });
576
- }
577
- /**
578
- *
579
- * @param body A type that defines the fields for the request to create a negative keyword.
580
- */
581
- createNegativeKeyword(body) {
582
- return this.post(`/negative_keyword`, body);
583
- }
584
- /**
585
- *
586
- * @param negativeKeywordId The unique identifier for the negative keyword.
587
- */
588
- getNegativeKeyword(negativeKeywordId) {
589
- negativeKeywordId = encodeURIComponent(negativeKeywordId);
590
- return this.get(`/negative_keyword/${negativeKeywordId}`);
591
- }
592
- /**
593
- *
594
- * @param negativeKeywordId The unique identifier for the negative keyword.
595
- * @param body A type that defines the fields for the request to update a negative keyword.
596
- */
597
- updateNegativeKeyword(negativeKeywordId, body) {
598
- negativeKeywordId = encodeURIComponent(negativeKeywordId);
599
- return this.put(`/negative_keyword/${negativeKeywordId}`, body);
600
- }
601
- /**
602
- * This call downloads the report as specified by the report_id path parameter.
603
- *
604
- * @param reportId The unique ID of the Promoted Listings report you want to get. This ID is generated by eBay when
605
- * you run a report task with a call to createReportTask.
606
- */
607
- getReport(reportId) {
608
- reportId = encodeURIComponent(reportId);
609
- return this.get(`/ad_report/${reportId}`);
610
- }
611
- /**
612
- * This call retrieves information that details the fields used in each of the Promoted Listings reports.
613
- */
614
- getReportMetadata() {
615
- return this.get(`/ad_report_metadata`);
616
- }
617
- /**
618
- * This call retrieves metadata that details the fields used by the Promoted Listings report type that's specified
619
- * by the report_type path parameter.
620
- *
621
- * @param reportType The name of the report type whose metadata you want to get.
622
- */
623
- getReportMetadataForReportType(reportType) {
624
- reportType = encodeURIComponent(reportType);
625
- return this.get(`/ad_report_metadata/${reportType}`);
626
- }
627
- /**
628
- * This method returns information on all the existing report tasks related to a seller.
629
- *
630
- * @param limit Specifies the maximum number of report tasks to return on a page in the paginated response.
631
- * Default: 10 Maximum: 500
632
- * @param offset Specifies the number of report tasks to skip in the result set before returning the first report
633
- * in the paginated response.
634
- * @param reportTaskStatuses This parameter filters the returned report tasks by their status. Supply a
635
- * comma-separated list of the report statuses you want returned.
636
- */
637
- getReportTasks({ limit, offset, reportTaskStatuses } = {}) {
638
- return this.get(`/ad_report_task`, {
639
- params: {
640
- limit,
641
- offset,
642
- report_task_statuses: reportTaskStatuses
643
- }
644
- });
645
- }
646
- /**
647
- * This call returns the details of a specific Promoted Listings report task, as specified by the report_task_id
648
- * path parameter. T
649
- *
650
- * @param reportTaskId A unique eBay-assigned ID for the report task that's generated when the report task is
651
- * created by a call to createReportTask.
652
- */
653
- getReportTask(reportTaskId) {
654
- reportTaskId = encodeURIComponent(reportTaskId);
655
- return this.get(`/ad_report_task/${reportTaskId}`);
656
- }
657
- /**
658
- * This method creates a report task, which generates a Promoted Listings report based on the values specified in
659
- * the call.
660
- *
661
- * @param body The container for the fields that define the report task.
662
- */
663
- createReportTask(body) {
664
- return this.post(`/ad_report_task`, body);
665
- }
666
- /**
667
- * This call deletes the report task specified by the report_task_id path parameter.
668
- *
669
- * @param reportTaskId A unique eBay-assigned ID for the report task that's generated when the report task is
670
- * created by a call to createReportTask.
671
- */
672
- deleteReportTask(reportTaskId) {
673
- reportTaskId = encodeURIComponent(reportTaskId);
674
- return this.delete(`/ad_report_task/${reportTaskId}`);
675
- }
676
- /**
677
- * This method creates an item price markdown promotion (know simply as a &quot;markdown promotion&quot;) where a
678
- * discount amount is applied directly to the items included the promotion.
679
- *
680
- * @param body This type defines the fields that describe an item price markdown promotion.
681
- */
682
- createItemPriceMarkdownPromotion(body) {
683
- return this.post(`/item_price_markdown`, body);
684
- }
685
- /**
686
- * This method updates the specified item price markdown promotion with the new configuration that you supply in
687
- * the payload of the request.
688
- *
689
- * @param promotionId The ID of the promotion you want to update.
690
- * @param body This type defines the fields that describe an item price markdown promotion.
691
- */
692
- updateItemPriceMarkdownPromotion(promotionId, body) {
693
- promotionId = encodeURIComponent(promotionId);
694
- return this.put(`/item_price_markdown/${promotionId}`, body);
695
- }
696
- /**
697
- * This method deletes the item price markdown promotion specified by the promotion_id path parameter.
698
- *
699
- * @param promotionId The ID of the promotion you want to delete.
700
- */
701
- deleteItemPriceMarkdownPromotion(promotionId) {
702
- promotionId = encodeURIComponent(promotionId);
703
- return this.delete(`/item_price_markdown/${promotionId}`);
704
- }
705
- /**
706
- * This method returns the complete details of the item price markdown promotion that's indicated by the
707
- * promotion_id path parameter.
708
- *
709
- * @param promotionId The ID of the promotion you want to retrieve.
710
- */
711
- getItemPriceMarkdownPromotion(promotionId) {
712
- promotionId = encodeURIComponent(promotionId);
713
- return this.get(`/item_price_markdown/${promotionId}`);
714
- }
715
- /**
716
- * This method creates an item promotion (known casually as a &quot;threshold promotion&quot;) where the buyer
717
- * receives a discount when they meet the buying criteria that's set for the promotion.
718
- *
719
- * @param body This type defines the fields that describe an item promotion.
720
- */
721
- createItemPromotion(body) {
722
- return this.post(`/item_promotion`, body);
723
- }
724
- /**
725
- * This method updates the specified threshold promotion with the new configuration that you supply in the request.
726
- *
727
- * @param promotionId The ID of the promotion you want to retrieve. The promotion ID is a unique eBay-assigned
728
- * value that's generated when the promotion is created.
729
- * @param body type defines the fields that describe an item promotion.
730
- */
731
- updateItemPromotion(promotionId, body) {
732
- promotionId = encodeURIComponent(promotionId);
733
- return this.put(`/item_promotion/${promotionId}`, body);
734
- }
735
- /**
736
- * This method deletes the threshold promotion specified by the promotion_id path parameter.
737
- *
738
- * @param promotionId The ID of the promotion you want to retrieve. The promotion ID is a unique eBay-assigned
739
- * value that's generated when the promotion is created.
740
- */
741
- deleteItemPromotion(promotionId) {
742
- promotionId = encodeURIComponent(promotionId);
743
- return this.delete(`/item_promotion/${promotionId}`);
744
- }
745
- /**
746
- * This method returns the complete details of the threshold promotion specified by the promotion_id path
747
- * parameter.
748
- *
749
- * @param promotionId The ID of the promotion you want to retrieve. The promotion ID is a unique eBay-assigned
750
- * value that's generated when the promotion is created.
751
- */
752
- getItemPromotion(promotionId) {
753
- promotionId = encodeURIComponent(promotionId);
754
- return this.get(`/item_promotion/${promotionId}`);
755
- }
756
- /**
757
- * This method returns the set of listings associated with the promotion_id specified in the path parameter.
758
- *
759
- * @param promotionId The ID of the promotion whose associated listings you want to retrieve.
760
- * @param limit Specifies the maximum number of promotions returned on a page from the result set. Default: 200
761
- * Maximum: 200
762
- * @param offset Specifies the number of promotions to skip in the result set before returning the first promotion
763
- * in the paginated response.
764
- * @param q Reserved for future use.
765
- * @param sort Specifies the order in which to sort the associated listings in the response.
766
- * @param status This query parameter applies only to markdown promotions.
767
- */
768
- getListingSet(promotionId, { limit, offset, q, sort, status } = {}) {
769
- promotionId = encodeURIComponent(promotionId);
770
- return this.get(`/promotion/${promotionId}/get_listing_set`, {
771
- params: {
772
- limit,
773
- offset,
774
- q,
775
- sort,
776
- status
777
- }
778
- });
779
- }
780
- /**
781
- * This method returns a list of a seller's undeleted promotions.
782
- *
783
- * @param marketplaceId The eBay marketplace ID of the site where the promotion is hosted.
784
- * @param limit Specifies the maximum number of promotions returned on a page from the result set. Default: 200
785
- * Maximum: 200
786
- * @param offset Specifies the number of promotions to skip in the result set before returning the first promotion
787
- * in the paginated response.
788
- * @param promotionStatus Specifies the promotion state by which you want to filter the results.
789
- * @param promotionType Filters the returned promotions based on the their campaign promotion type.
790
- * @param q A string consisting of one or more keywords.
791
- * @param sort Specifies the order for how to sort the response.
792
- */
793
- getPromotions(marketplaceId, { limit, offset, promotionStatus, promotionType, q, sort } = {}) {
794
- return this.get(`/promotion`, {
795
- params: {
796
- marketplace_id: marketplaceId,
797
- limit,
798
- offset,
799
- promotion_status: promotionStatus,
800
- promotion_type: promotionType,
801
- q,
802
- sort
803
- }
804
- });
805
- }
806
- /**
807
- * This method pauses a currently-active (RUNNING) threshold promotion and changes the state of the promotion from
808
- * RUNNING to PAUSED.
809
- *
810
- * @param promotionId Identifier of the promotion you want to pause.
811
- */
812
- pausePromotion(promotionId) {
813
- const id = encodeURIComponent(promotionId);
814
- return this.post(`/promotion/${id}/pause`);
815
- }
816
- /**
817
- * This method restarts a threshold promotion that was previously paused and changes the state of the promotion
818
- * from PAUSED to RUNNING.
819
- *
820
- * @param promotionId Identifier of the promotion you want to make active. The ID is a unique eBay-assigned value
821
- * that's generated when the promotion is created.
822
- */
823
- resumePromotion(promotionId) {
824
- const id = encodeURIComponent(promotionId);
825
- return this.post(`/promotion/${id}/resume`);
826
- }
827
- /**
828
- * This method generates a report that lists the seller's running, paused, and ended promotions for the specified
829
- * eBay marketplace.
830
- *
831
- * @param marketplaceId The eBay marketplace ID of the siteId for which you want the promotions report.
832
- * @param limit Specifies the maximum number of promotions returned on a page from the result set. Default: 200
833
- * Maximum: 200
834
- * @param offset Specifies the number of promotions to skip in the result set before returning the first promotion
835
- * in the paginated response.
836
- * @param promotionStatus Limits the results to the promotions that are in the state specified by this query
837
- * parameter.
838
- * @param promotionType Filters the returned promotions in the report based on the their campaign promotion type.
839
- * @param q A string consisting of one or more keywords. eBay filters the response by returning only the promotions
840
- * that contain the supplied keywords in the promotion title.
841
- */
842
- getPromotionReports(marketplaceId, { limit, offset, promotionStatus, promotionType, q } = {}) {
843
- return this.get(`/promotion_report`, {
844
- params: {
845
- marketplace_id: marketplaceId,
846
- limit,
847
- offset,
848
- promotion_status: promotionStatus,
849
- promotion_type: promotionType,
850
- q
851
- }
852
- });
853
- }
854
- /**
855
- * This method generates a report that summarizes the seller's promotions for the specified eBay marketplace.
856
- *
857
- * @param marketplaceId The eBay marketplace ID of the siteId you for which you want a promotion summary report.
858
- */
859
- getPromotionSummaryReport(marketplaceId) {
860
- return this.get(`/promotion_summary_report`, {
861
- params: {
862
- marketplace_id: marketplaceId
863
- }
864
- });
865
- }
866
- }
867
- exports.default = Marketing;
868
- Marketing.id = 'Marketing';
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const index_js_1 = __importDefault(require("../../index.js"));
7
+ /**
8
+ * <p>The <i>Marketing API </i> offers two platforms that sellers can use to promote and advertise their products:
9
+ * </p> <ul><li><b>Promoted Listings</b> is an eBay ad service that lets sellers set up <i>ad campaigns </i>
10
+ * for the products they want to promote. eBay displays the ads in search results and in other
11
+ * marketing modules as <b>SPONSORED</b> listings.
12
+ */
13
+ class Marketing extends index_js_1.default {
14
+ get basePath() {
15
+ return '/sell/marketing/v1';
16
+ }
17
+ /**
18
+ * This method creates an ad for each inventory reference ID specified in the request and associates the newly
19
+ * created ads with the specified campaign.
20
+ *
21
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created.
22
+ * @param body This type defines the fields for the bulkCreateAdsByInventoryReference request.
23
+ */
24
+ bulkCreateAdsByInventoryReference(campaignId, body) {
25
+ campaignId = encodeURIComponent(campaignId);
26
+ return this.post(`/ad_campaign/${campaignId}/bulk_create_ads_by_inventory_reference`, body);
27
+ }
28
+ /**
29
+ * This method creates an ad for each listing ID specified in the request and associates the newly created ads with
30
+ * the specified campaign.
31
+ *
32
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
33
+ * a seller's campaign IDs by calling getCampaigns.
34
+ * @param body The container for the bulk request to create ads for eBay listing IDs. eBay listing IDs are
35
+ * generated when the listing is created on eBay.
36
+ */
37
+ bulkCreateAdsByListingId(campaignId, body) {
38
+ campaignId = encodeURIComponent(campaignId);
39
+ return this.post(`/ad_campaign/${campaignId}/bulk_create_ads_by_listing_id`, body);
40
+ }
41
+ /**
42
+ * This method deletes a set of ads, as specified by a list of inventory reference IDs, from the specified
43
+ * campaign.
44
+ *
45
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
46
+ * a seller's campaign IDs by calling getCampaigns.
47
+ * @param body This type defines the fields for a bulkDeleteAdsByInventoryReference request.
48
+ */
49
+ bulkDeleteAdsByInventoryReference(campaignId, body) {
50
+ campaignId = encodeURIComponent(campaignId);
51
+ return this.post(`/ad_campaign/${campaignId}/bulk_delete_ads_by_inventory_reference`, body);
52
+ }
53
+ /**
54
+ * This method deletes a set of ads, as specified by a list of listing IDs, from the specified campaign.
55
+ *
56
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
57
+ * a seller's campaign IDs by calling getCampaigns.
58
+ * @param body This type defines the fields for the bulkDeleteAdsByListingId request.
59
+ */
60
+ bulkDeleteAdsByListingId(campaignId, body) {
61
+ campaignId = encodeURIComponent(campaignId);
62
+ return this.post(`/ad_campaign/${campaignId}/bulk_delete_ads_by_listing_id`, body);
63
+ }
64
+ /**
65
+ * This method replaces an ad bid based on a list of inventory references IDs associated with the specified
66
+ * campaign.
67
+ *
68
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created.
69
+ * @param body This type defines the fields for the BulkCreateAdsByInventoryReference request.
70
+ */
71
+ bulkUpdateAdsBidByInventoryReference(campaignId, body) {
72
+ campaignId = encodeURIComponent(campaignId);
73
+ return this.post(`/ad_campaign/${campaignId}/bulk_update_ads_bid_by_inventory_reference`, body);
74
+ }
75
+ /**
76
+ * This method replaces an ad bid based on a supplied list of listing IDs that are associated with the specified
77
+ * campaign.
78
+ *
79
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
80
+ * a seller's campaign IDs by calling getCampaigns.
81
+ * @param body Container for the bulk request to update ads.
82
+ */
83
+ bulkUpdateAdsBidByListingId(campaignId, body) {
84
+ campaignId = encodeURIComponent(campaignId);
85
+ return this.post(`/ad_campaign/${campaignId}/bulk_update_ads_bid_by_listing_id`, body);
86
+ }
87
+ /**
88
+ * This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
89
+ *
90
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
91
+ * a seller's campaign IDs by calling getCampaigns.
92
+ * @param body The bulk request to update the ads.
93
+ */
94
+ bulkUpdateAdsStatus(campaignId, body) {
95
+ campaignId = encodeURIComponent(campaignId);
96
+ return this.post(`/ad_campaign/${campaignId}/bulk_update_ads_status`, body);
97
+ }
98
+ /**
99
+ * This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program.
100
+ *
101
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
102
+ * a seller's campaign IDs by calling getCampaigns.
103
+ * @param body The bulk request to update ads.
104
+ */
105
+ bulkUpdateAdsStatusByListingId(campaignId, body) {
106
+ campaignId = encodeURIComponent(campaignId);
107
+ return this.post(`/ad_campaign/${campaignId}/bulk_update_ads_status_by_listing_id`, body);
108
+ }
109
+ /**
110
+ * This method retrieves all the ads for the specified campaign.
111
+ *
112
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
113
+ * a seller's campaign IDs by calling getCampaigns.
114
+ * @param limit Specifies the maximum number of ads to return on a page in the paginated response. Default: 10
115
+ * Maximum: 500
116
+ * @param listingIds A comma separated list of eBay listing IDs. The response includes only active ads (ads
117
+ * associated with a RUNNING campaign).
118
+ * @param offset Specifies the number of ads to skip in the result set before returning the first ad in the
119
+ * paginated response.
120
+ */
121
+ getAds(campaignId, { limit, listingIds, offset } = {}) {
122
+ campaignId = encodeURIComponent(campaignId);
123
+ return this.get(`/ad_campaign/${campaignId}/ad`, {
124
+ params: {
125
+ limit,
126
+ listing_ids: listingIds,
127
+ offset
128
+ }
129
+ });
130
+ }
131
+ /**
132
+ * This method creates an ad for the specified listing ID, sets the bid percentage for that specific item, and
133
+ * associates the ad with the specified campaign.
134
+ *
135
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
136
+ * a seller's campaign IDs by calling getCampaigns.
137
+ * @param body This type defines the fields for the createAd request.
138
+ */
139
+ createAdByListingId(campaignId, body) {
140
+ campaignId = encodeURIComponent(campaignId);
141
+ return this.post(`/ad_campaign/${campaignId}/ad`, body);
142
+ }
143
+ /**
144
+ * This method creates an ad for the specified inventory reference ID, sets the bid percentage for that specific
145
+ * item, and associates the ad with the specified campaign.
146
+ *
147
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
148
+ * a seller's campaign IDs by calling getCampaigns.
149
+ * @param body This type defines the fields for the createAdsByInventoryReference request.
150
+ */
151
+ createAdsByInventoryReference(campaignId, body) {
152
+ campaignId = encodeURIComponent(campaignId);
153
+ return this.post(`/ad_campaign/${campaignId}/create_ads_by_inventory_reference`, body);
154
+ }
155
+ /**
156
+ * This method retrieves the specified ad from the specified campaign.
157
+ *
158
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
159
+ * a seller's campaign IDs by calling getCampaigns.
160
+ * @param adId Identifier of an ad. This ID was generated when the ad was created.
161
+ */
162
+ getAd(campaignId, adId) {
163
+ campaignId = encodeURIComponent(campaignId);
164
+ adId = encodeURIComponent(adId);
165
+ return this.get(`/ad_campaign/${campaignId}/ad/${adId}`);
166
+ }
167
+ /**
168
+ * This method retrieves the specified ad from the specified campaign.
169
+ *
170
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created.
171
+ * @param adId Identifier of an ad. This ID was generated when the ad was created.
172
+ */
173
+ deleteAd(campaignId, adId) {
174
+ campaignId = encodeURIComponent(campaignId);
175
+ adId = encodeURIComponent(adId);
176
+ return this.delete(`/ad_campaign/${campaignId}/ad/${adId}`);
177
+ }
178
+ /**
179
+ * This method deletes ads using a list of seller inventory reference IDs that are associated with the specified
180
+ * campaign ID.
181
+ *
182
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
183
+ * a seller's campaign IDs by calling getCampaigns.
184
+ */
185
+ deleteAdsByInventoryReference(campaignId) {
186
+ campaignId = encodeURIComponent(campaignId);
187
+ return this.post(`/ad_campaign/${campaignId}/delete_ads_by_inventory_reference`);
188
+ }
189
+ /**
190
+ * This method retrieves ads from the specified campaign using the seller's inventory reference ID and inventory
191
+ * reference type.
192
+ *
193
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
194
+ * a seller's campaign IDs by calling getCampaigns.
195
+ * @param inventoryReferenceId The inventory reference ID associated with the ad you want returned.
196
+ * @param inventoryReferenceType The type of the inventory reference ID. Set this value to either INVENTORY_ITEM (a
197
+ * single listing) or INVENTORY_ITEM_GROUP (a multi-variation listing).
198
+ */
199
+ getAdsByInventoryReference(campaignId, inventoryReferenceId, inventoryReferenceType) {
200
+ campaignId = encodeURIComponent(campaignId);
201
+ return this.get(`/ad_campaign/${campaignId}/get_ads_by_inventory_reference`, {
202
+ params: {
203
+ inventory_reference_id: inventoryReferenceId,
204
+ inventory_reference_type: inventoryReferenceType
205
+ }
206
+ });
207
+ }
208
+ /**
209
+ * This method updates the bid for the specified ad in the specified campaign. In the request, supply the
210
+ * campaign_id and ad_id as a URI parameters.
211
+ *
212
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
213
+ * a seller's campaign IDs by calling getCampaigns.
214
+ * @param adId A unique eBay-assigned ID for an ad that's generated when an ad is created.
215
+ * @param body This type defines the fields for the updateBid request.
216
+ */
217
+ updateBid(campaignId, adId, body) {
218
+ campaignId = encodeURIComponent(campaignId);
219
+ adId = encodeURIComponent(adId);
220
+ return this.post(`/ad_campaign/${campaignId}/ad/${adId}/update_bid`, body);
221
+ }
222
+ /**
223
+ *
224
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
225
+ * a seller's campaign IDs by calling getCampaigns.
226
+ * @param adGroupStatus A comma-separated list of ad group statuses.
227
+ * @param limit The number of results, from the current result set, to be returned in a single page.
228
+ * @param offset The number of results that will be skipped in the result set.
229
+ */
230
+ getAdGroups(campaignId, { adGroupStatus, limit, offset } = {}) {
231
+ campaignId = encodeURIComponent(campaignId);
232
+ return this.get(`/ad_campaign/${campaignId}/ad_group`, {
233
+ params: {
234
+ ad_group_status: adGroupStatus,
235
+ limit,
236
+ offset
237
+ }
238
+ });
239
+ }
240
+ /**
241
+ *
242
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
243
+ * a seller's campaign IDs by calling getCampaigns.
244
+ * @param body This type defines the fields for the <b>createAdGroup</b> request.
245
+ */
246
+ createAdGroup(campaignId, body) {
247
+ campaignId = encodeURIComponent(campaignId);
248
+ return this.post(`/ad_campaign/${campaignId}/ad_group`, body);
249
+ }
250
+ /**
251
+ *
252
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
253
+ * a seller's campaign IDs by calling getCampaigns.
254
+ * @param adGroupId The ID of the ad group that shall be retrieved.
255
+ */
256
+ getAdGroup(campaignId, adGroupId) {
257
+ adGroupId = encodeURIComponent(adGroupId);
258
+ campaignId = encodeURIComponent(campaignId);
259
+ return this.get(`/ad_campaign/${campaignId}/ad_group/${adGroupId}`);
260
+ }
261
+ /**
262
+ *
263
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
264
+ * a seller's campaign IDs by calling getCampaigns.
265
+ * @param adGroupId The ID of the ad group that shall be retrieved.
266
+ * @param body This type defines the fields for the <b>UpdateAdGroup</b> request.
267
+ */
268
+ updateAdGroup(campaignId, adGroupId, body) {
269
+ adGroupId = encodeURIComponent(adGroupId);
270
+ campaignId = encodeURIComponent(campaignId);
271
+ return this.put(`/ad_campaign/${campaignId}/ad_group/${adGroupId}`, body);
272
+ }
273
+ /**
274
+ *
275
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
276
+ * a seller's campaign IDs by calling getCampaigns.
277
+ * @param adGroupId The ID of the ad group that shall be retrieved.
278
+ * @param body The data requested to retrieve the suggested bids.
279
+ */
280
+ suggestBids(campaignId, adGroupId, body) {
281
+ adGroupId = encodeURIComponent(adGroupId);
282
+ campaignId = encodeURIComponent(campaignId);
283
+ return this.post(`/ad_campaign/${campaignId}/ad_group/${adGroupId}/suggest_bids`, body);
284
+ }
285
+ /**
286
+ *
287
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
288
+ * a seller's campaign IDs by calling getCampaigns.
289
+ * @param adGroupId The ID of the ad group that shall be retrieved.
290
+ * @param body The required data to retrieve suggested keywords.
291
+ */
292
+ suggestKeywords(campaignId, adGroupId, body) {
293
+ adGroupId = encodeURIComponent(adGroupId);
294
+ campaignId = encodeURIComponent(campaignId);
295
+ return this.post(`/ad_campaign/${campaignId}/ad_group/${adGroupId}/suggest_keywords`, body);
296
+ }
297
+ /**
298
+ * This method clones (makes a copy of) the specified campaign.
299
+ *
300
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
301
+ * a seller's campaign IDs by calling getCampaigns.
302
+ * @param body This type defines the fields for a clone campaign request.
303
+ */
304
+ cloneCampaign(campaignId, body) {
305
+ campaignId = encodeURIComponent(campaignId);
306
+ return this.post(`/ad_campaign/${campaignId}/clone`, body);
307
+ }
308
+ /**
309
+ * This method retrieves the details for all the campaigns of a seller, including the campaign's the selection
310
+ * rules.
311
+ *
312
+ * @param campaignName Specifies the campaign name. The results are filtered to include only the campaign by the
313
+ * specified name.
314
+ * @param campaignStatus Specifies the campaign status. The results are filtered to include only campaigns that are
315
+ * in the specified states.
316
+ * @param endDateRange Specifies the range of a campaign's end date. The results are filtered to include only
317
+ * campaigns with an end date that is within specified range.
318
+ * @param limit Specifies the maximum number of campaigns to return on a page in the paginated response. Default:
319
+ * 10 Maximum: 500
320
+ * @param offset Specifies the number of campaigns to skip in the result set before returning the first report in
321
+ * the paginated response.
322
+ * @param startDateRange Specifies the range of a campaign's start date in which to filter the results.
323
+ */
324
+ getCampaigns({ campaignName, campaignStatus, endDateRange, limit, offset, startDateRange } = {}) {
325
+ return this.get(`/ad_campaign`, {
326
+ params: {
327
+ campaign_name: campaignName,
328
+ campaign_status: campaignStatus,
329
+ end_date_range: endDateRange,
330
+ limit,
331
+ offset,
332
+ start_date_range: startDateRange
333
+ }
334
+ });
335
+ }
336
+ /**
337
+ * This method retrieves the details of a single campaign, as specified with the campaign_id query parameter.
338
+ *
339
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
340
+ * a seller's campaign IDs by calling getCampaigns.
341
+ */
342
+ getCampaign(campaignId) {
343
+ campaignId = encodeURIComponent(campaignId);
344
+ return this.get(`/ad_campaign/${campaignId}`);
345
+ }
346
+ /**
347
+ * This method creates a Promoted Listings ad campaign.
348
+ *
349
+ * @param body his type defines the fields for the create campaign request.
350
+ */
351
+ createCampaign(body) {
352
+ return this.post(`/ad_campaign`, body);
353
+ }
354
+ /**
355
+ * This method deletes the campaign specified by the campaign_id query parameter.
356
+ *
357
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
358
+ * a seller's campaign IDs by calling getCampaigns.
359
+ */
360
+ deleteCampaign(campaignId) {
361
+ campaignId = encodeURIComponent(campaignId);
362
+ return this.delete(`/ad_campaign/${campaignId}`);
363
+ }
364
+ /**
365
+ * This method ends an active (RUNNINGM) or paused campaign. Specify the campaign you want to end by supplying its
366
+ * campaign ID in a query parameter.
367
+ *
368
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
369
+ * a seller's campaign IDs by calling getCampaigns.
370
+ */
371
+ endCampaign(campaignId) {
372
+ campaignId = encodeURIComponent(campaignId);
373
+ return this.post(`/ad_campaign/${campaignId}/end`);
374
+ }
375
+ /**
376
+ * This method retrieves the campaign containing the listing that is specified using either an eBay listing ID or
377
+ * an inventory reference ID and inventory reference type.
378
+ *
379
+ * @param inventoryReferenceId The seller's inventory reference ID of the listing to be used to find the campaign
380
+ * in which it is associated.
381
+ * @param inventoryReferenceType The type of the seller's inventory reference ID, which is a listing or group of
382
+ * items.
383
+ * @param listingId Identifier of the eBay listing associated with the ad.
384
+ */
385
+ findCampaignByAdReference({ inventoryReferenceId, inventoryReferenceType, listingId } = {}) {
386
+ return this.get(`/ad_campaign/find_campaign_by_ad_reference`, {
387
+ params: {
388
+ inventory_reference_id: inventoryReferenceId,
389
+ inventory_reference_type: inventoryReferenceType,
390
+ listing_id: listingId
391
+ }
392
+ });
393
+ }
394
+ /**
395
+ * This method retrieves the details of a single campaign, as specified with the campaign_name query parameter.
396
+ *
397
+ * @param campaignName Name of the campaign.
398
+ */
399
+ getCampaignByName(campaignName) {
400
+ return this.get(`/ad_campaign/get_campaign_by_name`, {
401
+ params: {
402
+ campaign_name: campaignName
403
+ }
404
+ });
405
+ }
406
+ /**
407
+ * This method pauses an active (RUNNING) campaign. You can restarted by calling resumeCampaign, as long as the
408
+ * campaign's end date is in the future..
409
+ *
410
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
411
+ * a seller's campaign IDs by calling getCampaigns.
412
+ */
413
+ pauseCampaign(campaignId) {
414
+ campaignId = encodeURIComponent(campaignId);
415
+ return this.post(`/ad_campaign/${campaignId}/pause`);
416
+ }
417
+ /**
418
+ * This method resumes a paused campaign, as long as it's end date is in the future.
419
+ *
420
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
421
+ * a seller's campaign IDs by calling getCampaigns.
422
+ */
423
+ resumeCampaign(campaignId) {
424
+ campaignId = encodeURIComponent(campaignId);
425
+ return this.post(`/ad_campaign/${campaignId}/resume`);
426
+ }
427
+ /**
428
+ *
429
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.
430
+ * @param categoryIds Specifies the category ID that is used to limit the results.
431
+ * @param limit Specifies the maximum number of campaigns to return on a page in the paginated response.
432
+ * @param offset Specifies the number of campaigns to skip in the result set before returning the first report in the paginated response.
433
+ */
434
+ suggestItems(campaignId, { categoryIds, limit, offset } = {}) {
435
+ campaignId = encodeURIComponent(campaignId);
436
+ return this.get(`/ad_campaign/${campaignId}/suggest_items`, {
437
+ params: {
438
+ category_ids: categoryIds,
439
+ limit,
440
+ offset
441
+ }
442
+ });
443
+ }
444
+ /**
445
+ *
446
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.
447
+ * @param body This type defines the request fields for the ad rate strategy that shall be updated.
448
+ */
449
+ updateAdRateStrategy(campaignId, body) {
450
+ campaignId = encodeURIComponent(campaignId);
451
+ return this.post(`/ad_campaign/${campaignId}/update_ad_rate_strategy`, body);
452
+ }
453
+ /**
454
+ *
455
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.
456
+ * @param body This type defines the request fields for the budget details that shall be updated.
457
+ */
458
+ updateCampaignBudget(campaignId, body) {
459
+ campaignId = encodeURIComponent(campaignId);
460
+ return this.post(`/ad_campaign/${campaignId}/update_campaign_budget`, body);
461
+ }
462
+ /**
463
+ * This method replaces the name and the start and end dates of a campaign.
464
+ *
465
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
466
+ * a seller's campaign IDs by calling getCampaigns.
467
+ * @param body This type defines the fields to updated the campaign name and start and end dates.
468
+ */
469
+ updateCampaignIdentification(campaignId, body) {
470
+ campaignId = encodeURIComponent(campaignId);
471
+ return this.post(`/ad_campaign/${campaignId}/update_campaign_identification`, body);
472
+ }
473
+ /**
474
+ *
475
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
476
+ * a seller's campaign IDs by calling getCampaigns.
477
+ * @param body A type that defines the fields for the bulk request to create keywords.
478
+ */
479
+ bulkCreateKeyword(campaignId, body) {
480
+ campaignId = encodeURIComponent(campaignId);
481
+ return this.post(`/ad_campaign/${campaignId}/bulk_create_keyword`, body);
482
+ }
483
+ /**
484
+ *
485
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
486
+ * a seller's campaign IDs by calling getCampaigns.
487
+ * @param body A type that defines the fields for the bulk request to update keywords.
488
+ */
489
+ bulkUpdateKeyword(campaignId, body) {
490
+ campaignId = encodeURIComponent(campaignId);
491
+ return this.post(`/ad_campaign/${campaignId}/bulk_update_keyword`, body);
492
+ }
493
+ /**
494
+ *
495
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
496
+ * a seller's campaign IDs by calling getCampaigns.
497
+ * @param adGroupIds A comma-separated list of ad group IDs.
498
+ * @param keywordStatus A comma-separated list of keyword statuses.
499
+ * @param limit Specifies the maximum number of results to return on a page in the paginated response.
500
+ * @param offset Specifies the number of results to skip in the result set before returning the first report in the paginated response.
501
+ */
502
+ getKeywords(campaignId, { adGroupIds, keywordStatus, limit, offset } = {}) {
503
+ campaignId = encodeURIComponent(campaignId);
504
+ return this.get(`/ad_campaign/${campaignId}/keyword`, {
505
+ params: {
506
+ ad_group_ids: adGroupIds,
507
+ keyword_status: keywordStatus,
508
+ limit,
509
+ offset
510
+ }
511
+ });
512
+ }
513
+ /**
514
+ *
515
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
516
+ * a seller's campaign IDs by calling getCampaigns.
517
+ * @param body A type that defines the fields for the request to create a keyword.
518
+ */
519
+ createKeyword(campaignId, body) {
520
+ campaignId = encodeURIComponent(campaignId);
521
+ return this.post(`/ad_campaign/${campaignId}/keyword`, body);
522
+ }
523
+ /**
524
+ *
525
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
526
+ * a seller's campaign IDs by calling getCampaigns.
527
+ * @param keywordId This path parameter is used to identify the keyword to retrieve.
528
+ */
529
+ getKeyword(campaignId, keywordId) {
530
+ campaignId = encodeURIComponent(campaignId);
531
+ keywordId = encodeURIComponent(keywordId);
532
+ return this.get(`/ad_campaign/${campaignId}/keyword/${keywordId}`);
533
+ }
534
+ /**
535
+ *
536
+ * @param campaignId A unique eBay-assigned ID for an ad campaign that's generated when a campaign is created. Get
537
+ * a seller's campaign IDs by calling getCampaigns.
538
+ * @param keywordId This path parameter is used to identify the keyword to retrieve.
539
+ * @param body A type that defines the fields for the request to update a keyword.
540
+ */
541
+ updateKeyword(campaignId, keywordId, body) {
542
+ campaignId = encodeURIComponent(campaignId);
543
+ keywordId = encodeURIComponent(keywordId);
544
+ return this.put(`/ad_campaign/${campaignId}/keyword/${keywordId}`, body);
545
+ }
546
+ /**
547
+ *
548
+ * @param body A type that defines the fields for the bulk request to create negative keywords.
549
+ */
550
+ bulkCreateNegativeKeyword(body) {
551
+ return this.post(`/bulk_create_negative_keyword`, body);
552
+ }
553
+ /**
554
+ *
555
+ * @param body A type that defines the fields for the bulk request to create negative keywords.
556
+ */
557
+ bulkUpdateNegativeKeyword(body) {
558
+ return this.post(`/bulk_update_negative_keyword`, body);
559
+ }
560
+ /**
561
+ *
562
+ * @param adGroupIds A comma-separated list of ad group IDs.
563
+ * @param campaignIds A unique eBay-assigned ID for an ad campaign that is generated when a campaign is created.
564
+ * @param limit The number of results, from the current result set, to be returned in a single page.
565
+ * @param negativeKeywordStatus A comma-separated list of negative keyword statuses.
566
+ * @param offset The number of results that will be skipped in the result set.
567
+ */
568
+ getNegativeKeywords({ adGroupIds, campaignIds, limit, negativeKeywordStatus, offset } = {}) {
569
+ return this.get(`/negative_keyword`, {
570
+ params: {
571
+ ad_group_ids: adGroupIds,
572
+ campaign_ids: campaignIds, limit,
573
+ negative_keyword_status: negativeKeywordStatus, offset
574
+ }
575
+ });
576
+ }
577
+ /**
578
+ *
579
+ * @param body A type that defines the fields for the request to create a negative keyword.
580
+ */
581
+ createNegativeKeyword(body) {
582
+ return this.post(`/negative_keyword`, body);
583
+ }
584
+ /**
585
+ *
586
+ * @param negativeKeywordId The unique identifier for the negative keyword.
587
+ */
588
+ getNegativeKeyword(negativeKeywordId) {
589
+ negativeKeywordId = encodeURIComponent(negativeKeywordId);
590
+ return this.get(`/negative_keyword/${negativeKeywordId}`);
591
+ }
592
+ /**
593
+ *
594
+ * @param negativeKeywordId The unique identifier for the negative keyword.
595
+ * @param body A type that defines the fields for the request to update a negative keyword.
596
+ */
597
+ updateNegativeKeyword(negativeKeywordId, body) {
598
+ negativeKeywordId = encodeURIComponent(negativeKeywordId);
599
+ return this.put(`/negative_keyword/${negativeKeywordId}`, body);
600
+ }
601
+ /**
602
+ * This call downloads the report as specified by the report_id path parameter.
603
+ *
604
+ * @param reportId The unique ID of the Promoted Listings report you want to get. This ID is generated by eBay when
605
+ * you run a report task with a call to createReportTask.
606
+ */
607
+ getReport(reportId) {
608
+ reportId = encodeURIComponent(reportId);
609
+ return this.get(`/ad_report/${reportId}`);
610
+ }
611
+ /**
612
+ * This call retrieves information that details the fields used in each of the Promoted Listings reports.
613
+ */
614
+ getReportMetadata() {
615
+ return this.get(`/ad_report_metadata`);
616
+ }
617
+ /**
618
+ * This call retrieves metadata that details the fields used by the Promoted Listings report type that's specified
619
+ * by the report_type path parameter.
620
+ *
621
+ * @param reportType The name of the report type whose metadata you want to get.
622
+ */
623
+ getReportMetadataForReportType(reportType) {
624
+ reportType = encodeURIComponent(reportType);
625
+ return this.get(`/ad_report_metadata/${reportType}`);
626
+ }
627
+ /**
628
+ * This method returns information on all the existing report tasks related to a seller.
629
+ *
630
+ * @param limit Specifies the maximum number of report tasks to return on a page in the paginated response.
631
+ * Default: 10 Maximum: 500
632
+ * @param offset Specifies the number of report tasks to skip in the result set before returning the first report
633
+ * in the paginated response.
634
+ * @param reportTaskStatuses This parameter filters the returned report tasks by their status. Supply a
635
+ * comma-separated list of the report statuses you want returned.
636
+ */
637
+ getReportTasks({ limit, offset, reportTaskStatuses } = {}) {
638
+ return this.get(`/ad_report_task`, {
639
+ params: {
640
+ limit,
641
+ offset,
642
+ report_task_statuses: reportTaskStatuses
643
+ }
644
+ });
645
+ }
646
+ /**
647
+ * This call returns the details of a specific Promoted Listings report task, as specified by the report_task_id
648
+ * path parameter. T
649
+ *
650
+ * @param reportTaskId A unique eBay-assigned ID for the report task that's generated when the report task is
651
+ * created by a call to createReportTask.
652
+ */
653
+ getReportTask(reportTaskId) {
654
+ reportTaskId = encodeURIComponent(reportTaskId);
655
+ return this.get(`/ad_report_task/${reportTaskId}`);
656
+ }
657
+ /**
658
+ * This method creates a report task, which generates a Promoted Listings report based on the values specified in
659
+ * the call.
660
+ *
661
+ * @param body The container for the fields that define the report task.
662
+ */
663
+ createReportTask(body) {
664
+ return this.post(`/ad_report_task`, body);
665
+ }
666
+ /**
667
+ * This call deletes the report task specified by the report_task_id path parameter.
668
+ *
669
+ * @param reportTaskId A unique eBay-assigned ID for the report task that's generated when the report task is
670
+ * created by a call to createReportTask.
671
+ */
672
+ deleteReportTask(reportTaskId) {
673
+ reportTaskId = encodeURIComponent(reportTaskId);
674
+ return this.delete(`/ad_report_task/${reportTaskId}`);
675
+ }
676
+ /**
677
+ * This method creates an item price markdown promotion (know simply as a &quot;markdown promotion&quot;) where a
678
+ * discount amount is applied directly to the items included the promotion.
679
+ *
680
+ * @param body This type defines the fields that describe an item price markdown promotion.
681
+ */
682
+ createItemPriceMarkdownPromotion(body) {
683
+ return this.post(`/item_price_markdown`, body);
684
+ }
685
+ /**
686
+ * This method updates the specified item price markdown promotion with the new configuration that you supply in
687
+ * the payload of the request.
688
+ *
689
+ * @param promotionId The ID of the promotion you want to update.
690
+ * @param body This type defines the fields that describe an item price markdown promotion.
691
+ */
692
+ updateItemPriceMarkdownPromotion(promotionId, body) {
693
+ promotionId = encodeURIComponent(promotionId);
694
+ return this.put(`/item_price_markdown/${promotionId}`, body);
695
+ }
696
+ /**
697
+ * This method deletes the item price markdown promotion specified by the promotion_id path parameter.
698
+ *
699
+ * @param promotionId The ID of the promotion you want to delete.
700
+ */
701
+ deleteItemPriceMarkdownPromotion(promotionId) {
702
+ promotionId = encodeURIComponent(promotionId);
703
+ return this.delete(`/item_price_markdown/${promotionId}`);
704
+ }
705
+ /**
706
+ * This method returns the complete details of the item price markdown promotion that's indicated by the
707
+ * promotion_id path parameter.
708
+ *
709
+ * @param promotionId The ID of the promotion you want to retrieve.
710
+ */
711
+ getItemPriceMarkdownPromotion(promotionId) {
712
+ promotionId = encodeURIComponent(promotionId);
713
+ return this.get(`/item_price_markdown/${promotionId}`);
714
+ }
715
+ /**
716
+ * This method creates an item promotion (known casually as a &quot;threshold promotion&quot;) where the buyer
717
+ * receives a discount when they meet the buying criteria that's set for the promotion.
718
+ *
719
+ * @param body This type defines the fields that describe an item promotion.
720
+ */
721
+ createItemPromotion(body) {
722
+ return this.post(`/item_promotion`, body);
723
+ }
724
+ /**
725
+ * This method updates the specified threshold promotion with the new configuration that you supply in the request.
726
+ *
727
+ * @param promotionId The ID of the promotion you want to retrieve. The promotion ID is a unique eBay-assigned
728
+ * value that's generated when the promotion is created.
729
+ * @param body type defines the fields that describe an item promotion.
730
+ */
731
+ updateItemPromotion(promotionId, body) {
732
+ promotionId = encodeURIComponent(promotionId);
733
+ return this.put(`/item_promotion/${promotionId}`, body);
734
+ }
735
+ /**
736
+ * This method deletes the threshold promotion specified by the promotion_id path parameter.
737
+ *
738
+ * @param promotionId The ID of the promotion you want to retrieve. The promotion ID is a unique eBay-assigned
739
+ * value that's generated when the promotion is created.
740
+ */
741
+ deleteItemPromotion(promotionId) {
742
+ promotionId = encodeURIComponent(promotionId);
743
+ return this.delete(`/item_promotion/${promotionId}`);
744
+ }
745
+ /**
746
+ * This method returns the complete details of the threshold promotion specified by the promotion_id path
747
+ * parameter.
748
+ *
749
+ * @param promotionId The ID of the promotion you want to retrieve. The promotion ID is a unique eBay-assigned
750
+ * value that's generated when the promotion is created.
751
+ */
752
+ getItemPromotion(promotionId) {
753
+ promotionId = encodeURIComponent(promotionId);
754
+ return this.get(`/item_promotion/${promotionId}`);
755
+ }
756
+ /**
757
+ * This method returns the set of listings associated with the promotion_id specified in the path parameter.
758
+ *
759
+ * @param promotionId The ID of the promotion whose associated listings you want to retrieve.
760
+ * @param limit Specifies the maximum number of promotions returned on a page from the result set. Default: 200
761
+ * Maximum: 200
762
+ * @param offset Specifies the number of promotions to skip in the result set before returning the first promotion
763
+ * in the paginated response.
764
+ * @param q Reserved for future use.
765
+ * @param sort Specifies the order in which to sort the associated listings in the response.
766
+ * @param status This query parameter applies only to markdown promotions.
767
+ */
768
+ getListingSet(promotionId, { limit, offset, q, sort, status } = {}) {
769
+ promotionId = encodeURIComponent(promotionId);
770
+ return this.get(`/promotion/${promotionId}/get_listing_set`, {
771
+ params: {
772
+ limit,
773
+ offset,
774
+ q,
775
+ sort,
776
+ status
777
+ }
778
+ });
779
+ }
780
+ /**
781
+ * This method returns a list of a seller's undeleted promotions.
782
+ *
783
+ * @param marketplaceId The eBay marketplace ID of the site where the promotion is hosted.
784
+ * @param limit Specifies the maximum number of promotions returned on a page from the result set. Default: 200
785
+ * Maximum: 200
786
+ * @param offset Specifies the number of promotions to skip in the result set before returning the first promotion
787
+ * in the paginated response.
788
+ * @param promotionStatus Specifies the promotion state by which you want to filter the results.
789
+ * @param promotionType Filters the returned promotions based on the their campaign promotion type.
790
+ * @param q A string consisting of one or more keywords.
791
+ * @param sort Specifies the order for how to sort the response.
792
+ */
793
+ getPromotions(marketplaceId, { limit, offset, promotionStatus, promotionType, q, sort } = {}) {
794
+ return this.get(`/promotion`, {
795
+ params: {
796
+ marketplace_id: marketplaceId,
797
+ limit,
798
+ offset,
799
+ promotion_status: promotionStatus,
800
+ promotion_type: promotionType,
801
+ q,
802
+ sort
803
+ }
804
+ });
805
+ }
806
+ /**
807
+ * This method pauses a currently-active (RUNNING) threshold promotion and changes the state of the promotion from
808
+ * RUNNING to PAUSED.
809
+ *
810
+ * @param promotionId Identifier of the promotion you want to pause.
811
+ */
812
+ pausePromotion(promotionId) {
813
+ const id = encodeURIComponent(promotionId);
814
+ return this.post(`/promotion/${id}/pause`);
815
+ }
816
+ /**
817
+ * This method restarts a threshold promotion that was previously paused and changes the state of the promotion
818
+ * from PAUSED to RUNNING.
819
+ *
820
+ * @param promotionId Identifier of the promotion you want to make active. The ID is a unique eBay-assigned value
821
+ * that's generated when the promotion is created.
822
+ */
823
+ resumePromotion(promotionId) {
824
+ const id = encodeURIComponent(promotionId);
825
+ return this.post(`/promotion/${id}/resume`);
826
+ }
827
+ /**
828
+ * This method generates a report that lists the seller's running, paused, and ended promotions for the specified
829
+ * eBay marketplace.
830
+ *
831
+ * @param marketplaceId The eBay marketplace ID of the siteId for which you want the promotions report.
832
+ * @param limit Specifies the maximum number of promotions returned on a page from the result set. Default: 200
833
+ * Maximum: 200
834
+ * @param offset Specifies the number of promotions to skip in the result set before returning the first promotion
835
+ * in the paginated response.
836
+ * @param promotionStatus Limits the results to the promotions that are in the state specified by this query
837
+ * parameter.
838
+ * @param promotionType Filters the returned promotions in the report based on the their campaign promotion type.
839
+ * @param q A string consisting of one or more keywords. eBay filters the response by returning only the promotions
840
+ * that contain the supplied keywords in the promotion title.
841
+ */
842
+ getPromotionReports(marketplaceId, { limit, offset, promotionStatus, promotionType, q } = {}) {
843
+ return this.get(`/promotion_report`, {
844
+ params: {
845
+ marketplace_id: marketplaceId,
846
+ limit,
847
+ offset,
848
+ promotion_status: promotionStatus,
849
+ promotion_type: promotionType,
850
+ q
851
+ }
852
+ });
853
+ }
854
+ /**
855
+ * This method generates a report that summarizes the seller's promotions for the specified eBay marketplace.
856
+ *
857
+ * @param marketplaceId The eBay marketplace ID of the siteId you for which you want a promotion summary report.
858
+ */
859
+ getPromotionSummaryReport(marketplaceId) {
860
+ return this.get(`/promotion_summary_report`, {
861
+ params: {
862
+ marketplace_id: marketplaceId
863
+ }
864
+ });
865
+ }
866
+ }
867
+ Marketing.id = 'Marketing';
868
+ exports.default = Marketing;