文档中心 > API类目 > 海外-淘宝客API

taobao.ovs.tbk.material.item.link.convert (淘宝客-推广者-商品链接转换正式版)

淘宝客-推广者-商品链接转换正式版,商品ID或者商品链接转链API,支持入参推广者对应的“推广位”、商品ID,获取推广者对应的推广链接,优先返回联盟优惠券推广链接。 -- Single Item Link Conversion, Convert item ID or link to promotion link using adzone ID. Coupon links are prioritized.

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
site String 必须 TW
  • 默认值:GLOBAL
  • 站点标识:TW(台湾);HK(香港);MY(马来);SG(新加坡);AU(澳大利亚);CA(加拿大);MO(澳门);GLOBAL(全球),GLOBAL(全球)不存在禁限售的逻辑,若填写指定的站点,会校验禁限售的逻辑。 -- Site Identifier: TW (Taiwan); HK (Hong Kong); MY (Malaysia); SG (Singapore); AU (Australia); CA (Canada); MO (Macau); GLOBAL (Global). The "GLOBAL" identifier does not apply any restricted or prohibited sales logic. If a specific site is specified, the restricted/prohibited sales logic will be enforced.
    unid String 可选 123 渠道自定义参数 -- Channel Custom Parameter
    urls String 可选 https://item.taobao.com/item.htm?id=898150820782 商品链接串,用,分割,最大40个 -- Product link string, separated by commas, maximum 40 entries.
    item_ids String 可选 O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ 商品ID串,用,分割,最大40个 -- Product ID string, separated by commas, maximum 40 entries.
    adzone_id Number 必须 123 推广位ID,mm_xxx_xxx_12345678三段式的最后一段数字 -- Promotion position ID, the last segment of numbers in the three-part format mm_xxx_xxx_12345678.
    language String 必须 zh_CN
  • 默认值:zh_CN
  • 语言:zh_CN(中文);en_US(英文) -- Language: zh_CN (Chinese); en_US (English)

    响应参数

    名称 类型 示例值 描述
    items MaterialItemSummaryInfo [] 商品列表 – Product list
    • └ item_id
    • String
    • O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ
    • 商品信息-淘宝客新商品ID – Product information - Taobao Partner new product ID
    • coupon_info
    • MaterialItemCouponInfoDTO
    • 商品优惠券信息 – Product coupon information
    • └ coupon_start_fee
    • String
    • 17
    • 优惠券信息-满减的满额 – Coupon information - Minimum amount for discount
    • └ coupon_remain_count
    • Number
    • 27000
    • 优惠券信息-券数量 – Coupon information - Number of coupons
    • └ coupon_amount
    • String
    • 5
    • 优惠券信息-券面额 – Coupon information - Coupon value
    • └ coupon_activity_id
    • String
    • 30660aec6d334a929186b8ca49892bca
    • 优惠券信息-券模版ID – Coupon information - Coupon template ID
    • └ coupon_sale_text_info
    • String
    • 满17元减5元
    • 优惠券信息-券文案 – Coupon information - Coupon description
    • └ coupon_effective_start_time
    • Number
    • 1748361600000
    • 优惠券信息-券有效时间-开始时间 毫秒时间戳 – Coupon information - Coupon validity period - Start time (in milliseconds timestamp)
    • └ coupon_effective_end_time
    • Number
    • 1749052799000
    • 优惠券信息-券有效时间-结束时间 毫秒时间戳 – Coupon information - Coupon validity period - End time (in milliseconds timestamp)
    • publish_info
    • MaterialItemPublishInfoDTO
    • 淘客推广信息 – Taobao Partner promotion information
    • └ click_url
    • String
    • https://intl.taobao.com/dp?h5Url=https%3A%2F%2Fpre-wormhole.tmall.com%2Fwow%2Fz%2Foversea%2Fgam%2Fpre-ovs-affiliate-pdp%3Fwh_showError%3Dtrue%26itemId%3D527575926534%26pid%3Dmm_26632943_457000242_108856900407%26relationId%3D2852359894%26language%3Dzh_CN%26site%3DOTHER%26ovs_scene%3Dtop_api_link_convert%26is_ovs_cpa%3D1%26ovs_cpa_scene%3Daffiliate_joint_attribution
    • 默认跳转链接 – Default redirect link
    • └ income_rate
    • String
    • 15.01
    • 商品信息-收入比率(%);商品佣金比率+补贴比率 – Product information - Revenue ratio (%); Commission ratio + Subsidy ratio
    • └ commission_type
    • String
    • MKT
    • 佣金类型。MKT表示营销计划,SP表示定向计划,COMMON表示通用计划,ZX表示自选计划 – Commission type. MKT represents Marketing Plan, SP represents Targeted Plan, COMMON represents General Plan, ZX represents Custom Plan
    • └ coupon_share_url
    • String
    • https://intl.taobao.com/dp?h5Url=https%3A%2F%2Fpre-wormhole.tmall.com%2Fwow%2Fz%2Foversea%2Fgam%2Fpre-ovs-affiliate-pdp%3Fwh_showError%3Dtrue%26itemId%3D527575926534%26pid%3Dmm_26632943_457000242_108856900407%26relationId%3D2852359894%26language%3Dzh_CN%26site%3DOTHER%26ovs_scene%3Dtop_api_link_convert%26is_ovs_cpa%3D1%26ovs_cpa_scene%3Daffiliate_joint_attribution
    • 券二合一页链接 – Combined coupon page link
    • price_promotion_info
    • MaterialItemPromotionInfoDTO
    • 价格促销信息 – Price promotion information
    • └ reserve_price
    • String
    • 69.8
    • 商品信息-一口价,通常显示为划线价 – Product information - Fixed price, usually displayed as a strike-through price
    • └ final_promotion_price
    • String
    • 9.9
    • 促销信息-预估到手价(元)。若属于预售商品,付定金时间内,预估到手价价=定金+尾款的预估到手价 – Promotion information - Estimated final price (CNY). If it's a pre-sale item, during the deposit payment period, estimated final price = deposit + estimated final price of the balance
    • └ zk_final_price
    • String
    • 17.9
    • 促销信息-销售价格,无促销时等于一口价,有促销时为促销价。若属于预售商品,付定金时间内,在线售卖价=预售价 – Promotion information - Selling price, equals fixed price when no promotion is active, and equals promotional price when a promotion is active. If it's a pre-sale item, during the deposit payment period, online selling price = pre-sale price

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    OvsTbkMaterialItemLinkConvertRequest req = new OvsTbkMaterialItemLinkConvertRequest();
    req.setSite("TW");
    req.setUnid("123");
    req.setUrls("https://item.taobao.com/item.htm?id=898150820782");
    req.setItemIds("O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ");
    req.setAdzoneId(123L);
    req.setLanguage("zh_CN");
    OvsTbkMaterialItemLinkConvertResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <ovs_tbk_material_item_link_convert_response>
        <items>
            <material_item_summary_info>
                <item_id>O0rq6kjfzt6WxJ3gj8H42ahkiJ-5Aqw2ATWpWVJn09UZ</item_id>
                <coupon_info>
                    <coupon_start_fee>17</coupon_start_fee>
                    <coupon_remain_count>27000</coupon_remain_count>
                    <coupon_amount>5</coupon_amount>
                    <coupon_activity_id>30660aec6d334a929186b8ca49892bca</coupon_activity_id>
                    <coupon_sale_text_info>满17元减5元</coupon_sale_text_info>
                    <coupon_effective_start_time>1748361600000</coupon_effective_start_time>
                    <coupon_effective_end_time>1749052799000</coupon_effective_end_time>
                </coupon_info>
                <publish_info>
                    <click_url>https://intl.taobao.com/dp?h5Url=https%3A%2F%2Fpre-wormhole.tmall.com%2Fwow%2Fz%2Foversea%2Fgam%2Fpre-ovs-affiliate-pdp%3Fwh_showError%3Dtrue%26itemId%3D527575926534%26pid%3Dmm_26632943_457000242_108856900407%26relationId%3D2852359894%26language%3Dzh_CN%26site%3DOTHER%26ovs_scene%3Dtop_api_link_convert%26is_ovs_cpa%3D1%26ovs_cpa_scene%3Daffiliate_joint_attribution</click_url>
                    <income_rate>15.01</income_rate>
                    <commission_type>MKT</commission_type>
                    <coupon_share_url>https://intl.taobao.com/dp?h5Url=https%3A%2F%2Fpre-wormhole.tmall.com%2Fwow%2Fz%2Foversea%2Fgam%2Fpre-ovs-affiliate-pdp%3Fwh_showError%3Dtrue%26itemId%3D527575926534%26pid%3Dmm_26632943_457000242_108856900407%26relationId%3D2852359894%26language%3Dzh_CN%26site%3DOTHER%26ovs_scene%3Dtop_api_link_convert%26is_ovs_cpa%3D1%26ovs_cpa_scene%3Daffiliate_joint_attribution</coupon_share_url>
                </publish_info>
                <price_promotion_info>
                    <reserve_price>69.8</reserve_price>
                    <final_promotion_price>9.9</final_promotion_price>
                    <zk_final_price>17.9</zk_final_price>
                </price_promotion_info>
            </material_item_summary_info>
        </items>
    </ovs_tbk_material_item_link_convert_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部