Marketplace 合作伙伴商品 API

requests

一个商品数组中每个商品的方法和字段。

data

要创建、更新或删除的商品的信息。

title

字符串（字符数上限：200）

必要

显示在 Marketplace 交易帖中的商品的标题。

此文本会显示在 Marketplace 上。不要在其中包含 HTML 标签。

condition

枚举 {new, refurbished, used, used_like_new, used_good, used_fair, cpo, open_box_new}

必要

商品状况。

partner_product_condition

枚举 {acceptable, brand_new, certified_pre_owned, certified_refurbished, damaged, digital_good, excellent_refurbished, for_parts_or_not_working, good, good_refurbished, graded, like_new, new, new_other, new_other_see_details, new_with_box, new_with_defects, new_with_tags, open_box, others, pre_owned, remanufactured, retread, seller_refurbished, ungraded, used, very_good, very_good_refurbished, new_open_box, open_box_used, new_factory_sealed, unknown}

非必要

商品状况。此字段是非必要字段，会覆盖 condition 字段的值。如果需要更具体的商品状况，请使用此字段。

price

字符串（字符数上限：9999）

必要

价格的格式为数字，然后紧跟着一个空格，随后是 3 个字母组成的 ISO 4217 货币代码。例如 10.99 EUR

如果交易帖类型为“auction”，这便是商品的竞价。价格的格式为数字，然后紧跟着一个空格，随后是 3 个字母组成的 ISO 4217 货币代码。

link

字符串

必要

商品详情页面的移动网址网页链接。

partner_product_html_desc_uri

字符串

非必要

指向包含商品完整描述的网站的网址链接。如果商品描述超出了“description”文本字段的容量限制，则使用此链接。Marketplace 将选择性地提供指向完整描述的链接。

partner_seller_id

字符串（字符数上限：100）

必要

卖家的唯一标识符，需要与卖家信息中的 partner_seller_id 匹配。

示例：“partner_seller_id”: “great_seller_inc”

fb_product_category

字符串

非必要

商品的 Facebook 商品类别。此清单中最具体的 Facebook 商品类别：电子表格 (.csv) 或纯文本 (.txt)。

sale_price

字符串

非必要

价格的格式为数字，然后紧跟着一个空格，随后是 3 个字母组成的 ISO 4217 货币代码。例如 10.99 EUR。此字段的格式与 price 字段相同。与 price 字段一起使用可显示折扣。

additional_image_link

字符串（字符数上限：2000）

非必要

商品额外图片（最多 20 个）的网址，网址间以逗号 (,)、分号 (;)、空格 ( ) 或竖线 (|) 分隔。请遵守与 image_link 相同的图片规范。

partner_attribute_data

可为空的 JSON 对象 { “color”: “blue” }

可用键：aspect_ratio、band_material、bike_type、brand、break_type、cable_length、capacity、case_size、certification、character、circulated_uncirculated、closure、color、compatible_bike_type、compatible_brand、compatible_model、compatible_operating_system、compatible_product、connectivity、credit_included、denomination、department、display_technology、dress_length、exterior_color、exterior_material、fabric_type、features、film_format、fit、focal_length、focus_type、form_factor、format、frame_color、game_name、game、gauge、golf_club_type、handedness、inseam、internet_connectivity、item_height、item_length、item_weight、item_width、items_included、main_stone、manufacturer_part_number、manufacturer、material、maximum_aperture、maximum_magnification、maximum_resolution、memory_cards_supported、metal_purity、metal、model、mount、mpn、network、number_of_items、occasion、outer_shell_material、package_quantity、part_type、pattern、performance_activity、platform、processor、publication_name、quantity、rack_type、rim_diameter、rim_width、ring_size、screen_size、section_width、series、set_includes、set、size_type、size、skirt_length、sleeve_length、sport_activity、sport、storage_capacity、style、type、unit_quantity、unit_type、upper_material、us_shoe_size、vintage、voltage、volume、waist_size、wheel_diameter、year

非必要

将显示在商品详细信息部分的属性键值列表，其中值的格式为字符串。

适用于房屋租赁/房地产的键：property_types（必要）、sale_type、bed_bath、area_size、pet_friendly、ac_type、heating_type、laundry_type、parking_type、parkingSpace、furnishing_type、garden_type、tenure_type、listed_by、property_tax_and_condo_fee、construction_status、lease_duration、energy_rating_eu、co2_emission_rating

适用于汽车的键：vehicle_type、year、make、model、number_of_owners、trim、body_style、exterior_color、interior_color、transmission、fuel_type、mileage、money_still_owed、motorcycle_type、engine_size

partner_product_location

字符串

非必要

以字符串形式显示的商品位置。示例：“Paris, France”。对具体或宽泛的范围没有限制。

partner_delivery_method

字符串枚举数组 {shipping, in_person}

非必要

此字段表示商品如何配送给买家。如果商品既可以邮寄，也可以由买家自提，则应同时包括这两种方式。
示例：[“shipping”,”in_person”]

默认：[“shipping”]

partner_item_longitude

浮点数

非必要

商品的经度。如果配送方式包括“in_person”，则为必要。

partner_shipping_cost

浮点数

非必要

如果 partner_shipping_type 的值为“fixed”，则为必要。
示例：“14.95”

partner_auction_bid_close_time

UTC 时间的 UNIX 时间戳，以秒为单位（数字）

非必要

如果 partner_listing_type 设为“auction”，则为必要。这是商品竞价结束的时间。示例：“partner_auction_bid_close_time”: 1713917255

additional_fields

可为空的 JSON 对象

自由格式（无固定枚举/键）

{ “revised_title”: “Premium Blue T-Shirt” }

非必要

自由格式的 Json 字段，供合作伙伴发送任何其他字段。