MerchandiseProductRequest

Merchandising changes to apply to a product in a single call.

Every field is optional; an omitted field leaves that facet unchanged. The changes are applied together: transaction type first, then show membership, then profile-shop publication.

  • reserve_for_live
    Type: booleannullable

    Whether the product is held for live shows only. Auctions are always reserved for live, so this is rejected as false when transaction_type is auction in the same request, and ignored for a product that is already an auction. A buy-it-now product is purchasable on the seller's profile shop only when this is not true. When omitted, the product's current choice is kept. A draft buy-it-now product with no choice yet is treated as false when transaction_type is set, which publishes it to the profile shop. Switching to auction records the product as reserved for live, so switching back to buy-it-now keeps it off the profile shop until this is sent as false.

  • shows
    Type: nullable

    The change to which shows the product appears in. Adding a product to a show that is not among the seller's next upcoming shows is applied in the background. Omit to leave the product's shows unchanged.

    Properties: 2
  • transaction_type
    Type: enumnullable

    The product's sale format. When provided, overwrites the format on the product. Auctions are always reserved for live and are sold only in shows; add the product to one with shows, in this call or a later one, or it is not purchasable anywhere.

    values
    buy_it_nowauction
Previous
LabelGenerationAcceptedResponse
Next
MerchandiseProductResponse