Product object

    Product object


    Article summary

    Product object

    Property name

    Type

    Description

    productId

    Long!

    Automatically generated unique product ID.

    customerProductId

    String?

    Customer's product ID and must be unique(defined by the customer). customerProductId can be set by Product API only and Shoplive Admin tool doesn't support the input form of this field at the moment. Shoplive Admin interface will be updated soon to accommodate this field.

    name

    String!

    Product name.

    brand

    String?

    Brand name.

    brandIdentifier

    String?

    Brand id set by the customer.

    description

    String?

    Description of the product.

    url

    String!

    Product URL. When clicking the product info on the Shoplive Player, this is the destination URL.

    sku

    String?

    Product SKU information (defined by the customer)

    imageUrl

    String?

    Product image URL.

    currency

    String!

    Currency of the price.

    showPrice

    Boolean!

    Whether show the price or not on the Shoplive Player.

    originalPrice

    Double?

    e.g. 20.00 ($20.00 if the currency is USD)

    discountPrice

    Double?

    e.g. 15.00 ($20.00 if the currency is USD)

    discountRate

    Double?

    e.g. 25.00 (if the discount rate is 25%)

    enableAuction

    Boolean!

    Whether the product supports an auction.

    bidStartingPrice

    Double?

    Starting price of the auction. (e.g. 0.99) This value is required when the enableAuction is true.

    bidDuration

    Integer?

    Bidding duration of the auction in seconds. This value is required when the enableAuction is true.

    bidIncrementalAmount

    Double?

    The incremental amount of the bidding. (e.g. 1.00) This value is required when the enableAuction is true.

    extendBidDuration

    Boolean?

    Whether to extend the remaining time to bid. If there is a bid when the remaining time is less than 10 seconds, the time will be increased by 10 seconds. The default value is true.

    ctaButtonTitle

    String?

    You can customize the CTA(call-to-action) title of the product. As it requires UI customization, it needs to be discussed with Shoplive. Please contact ask@shoplive.cloud if you want to use this feature.

    locked

    Boolean!

    In the case of true, this product belongs to specific campaigns and cannot be deleted.

    seller

    Seller?

    Seller information that owns the product.

    createdAt

    String!

    Created DateTime when the campaign is created (format: YYYY-MM-DD'T'HH:mm:ss'Z')

    updatedAt

    String!

    Updated DateTime when the campaign is updated (format: YYYY-MM-DD'T'HH:mm:ss'Z')


    Sample

    General product

    Auction product

    {
        "productId": "1004",
        "customerProductId": "SHOPLIVE_PRODUCT_4",
        "name": "Mug",
        "brand": "SHOPLIVE",
        "description": null,
        "url": "https://www.shoplive.cloud/en",
        "sku": "SKU004",
        "imageUrl": "https://image.shoplive.cloud/b22c72c7-d2f8-49c3-83f0-314c59740649.jpeg",
        "currency": "USD",
        "showPrice": true,
        "originalPrice": 10.0,
        "discountPrice": 7.0,
        "discountRate": 30.0,
        "enableAuction": true,
        "bidStartingPrice": 7.0,
        "bidDuration": 120,
        "bidIncrementalAmount": 1.0,
        "extendBidDuration": true,
        "ctaButtonTitle": "Bid",
        "locked": false,
        "seller": {
            "sellerId": "1",
            "name": "Shoplive Product Store",
            "profileUrl": "https://image.shoplive.cloud/7910e586-19a4-4740-804b-5f9da02e6939.jpg",
            "storeUrl": "https://shoplive.cloud",
            "description": "Description of the seller",
            "schemes": null
        },
        "createdAt": "2022-05-20T08:01:05Z",
        "updatedAt": "2022-05-20T11:27:34Z"
    }