This call is used to end a multiple-variation eBay listing that is associated with the specified inventory item group. This call only ends multiple-variation eBay listing associated with the inventory item group but does not delete the inventory item group object. Similarly, this call also does not delete any of the offers associated with the inventory item group, but instead all of these offers go into the unpublished state. If the seller wanted to relist the multiple-variation eBay listing, they could use the publishOfferByInventoryItemGroup method.
This request requires an access token created with the authorization code grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):
Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.
Sample 1: Withdrawing an Offer by Inventory Item Group
This call will end the multiple-variation eBay listing that is associated with the inventory item group. However, the Inventory Item Group and Offer objects (associated with the group) will still remain. The Offer objects will be converted from the published to unpublished state. If the seller wanted to relist the multiple-variation eBay listing, they could use the publishOfferByInventoryItemGroup call.
The inventoryItemGroupKey value associated with the inventory item group (on which the multiple-variation eBay listing is based on) to withdraw is passed into the request payload. The identifier of the eBay Marketplace is also required.