通过 JSON 结构上传商品
你可以使用本接口批量上传商品到商品库（单次最多可上传 5,000 个商品），系统将会异步录入请求中的商品。您将会从返回中得到一个任务处理 IDfeed_log_id。通过该 ID 您可以调用/catalog/product/log/查看任务的处理状态和最终结果。
和/catalog/product/file/接口不同，该接口主要用于少量商品上传及部分字段更新。对于更新频率比较高（高于一天一次）的商品库，也建议通过该接口进行上传。
注意
- 同一电商商品库下 SKU 唯一，且仅归属于某一更新源。针对某 SKU 的所有操作需要在其归属的更新源下进行。
- 允许向每个商品库每小时发送 1,000 次请求。
- 上传采用的是增量更新方式，新的上传不会移除历史上传数据。 重复上传同一个商品，将会覆盖之前的信息。
- 商品图片（
image_url）规格必须大于等于 500x500 像素，否则商品将无法通过审核。详细信息请参考商品图片要求。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/catalog/product/upload/| /v1.3/catalog/product/upload/|
|请求参数名称|dpa_products<br>image_link<br>video_link<br>additional_image_link<br>gtin<br>mpn<br>profession<br>product_type<br>price<br>landing_url<br>link<br>ext|products<br>image_url<br>video_url<br>additional_image_urls<br>global_trade_item_number<br>manufacturer_part_number<br>product_detail<br>product_category<br>price_info<br>landing_page<br>landing_page_url<br>extra_info|
|请求参数类型|bc_id: number<br>catalog_id: number|bc_id: string<br>catalog_id: string|
|请求参数名称和类型 |feed_ids: number|feed_id: string|
|新增请求参数 |/| 对于酒店商品库： <br>hotel_id<br>name<br>hotel_retailer_id<br>address<br>postal_code<br>latitude<br>longitude<br>margin_level<br>loyalty_program<br>guest_ratings<br>star_rating<br>room_type<br>hotel_category<br>neighborhood<br>priority<br>internal_label_0<br>internal_label_1<br> 对于航班商品库：<br>origin_airport<br>destination_airport<br>origin_city<br>destination_city<br>cabin_class<br>airline_company<br>priority<br>internal_label_0<br>internal_label_1<br> 对于目的地商品库:<br>destination_id<br>destination_name<br>address<br>postal_code<br>latitude<br>longitude<br>types<br>neighborhood<br>对于娱乐商品库：<br>media_title_id<br>genres<br>qid<br>对于汽车库存商品库:<br>vehicle_id<br>address<br>latitude<br>longitude<br>state_of_vehicle<br>vehicle_type<br>make<br>model<br>trim<br>year<br>vin<br>mileage<br>body_style<br>exterior_color<br>interior_color<br>transmission<br>drivetrain<br>fuel_type<br>dealer<br>date_first_on_lot<br>days_on_lot<br>offer_type<br>term_length<br>offer_term_qualifier<br>amount_price<br>amount_percentage<br>amount_qualifier<br>downpayment<br>downpayment_qualifier<br>offer_disclaimer<br>offer_disclaimer_url<br>emission_disclaimer<br>emission_disclaimer_url<br>emission_overlay_disclaimer<br>emission_image_link<br>video_url<br>对于汽车型号商品库:<br><br>vehicle_id<br>make<br>model<br>trim<br>year<br>exterior_color<br>offer_type<br>term_length<br>offer_term_qualifier<br>amount_price<br>amount_percentage<br>amount_qualifier<br>downpayment<br>downpayment_qualifier<br>offer_disclaimer<br>offer_disclaimer_url<br>emission_disclaimer<br>emission_disclaimer_url<br>emission_overlay_disclaimer<br>emission_image_link<br>video_url<br> 对于短剧商品库：<br>series_id<br>series_name<br>type<br>purchase_unit<br>cost<br>company_type<br>copyright_holder_name<br>app_id<br>minis_id<br>total_episodes<br>initial_paid_episodes<br>per_episode_duration<br>spoken_language<br>subtitle_language<br>production_type<br>target_audience<br>characters<br>genres<br>historical_context<br>actors<br>target_config<br>video_url|
|返回参数类型|feed_log_id: number|feed_log_id`: string|
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/catalog/product/upload/
**方法** POST
**Header**
```xtable
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://business-api.tiktok.com/portal/docs/marketing-api-authentication/v1.3)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许值：`application/json`。|
参数
| 字段{30%} | 类型{15%} | 描述{55%} |
|---|---|---|
|bc_id {必填}| string|商务中心 ID。|
|catalog_id {必填}| string|商品库 ID。|
|feed_id| string|商品库更新源 ID。|
|products {必填}|object[]|商品列表。<br>本数组中包含的参数请查看下文的<strong>“对象数组`products` 参数”</strong>小节。|
对象数组products参数
对象数组products中的可选参数随您想将商品上传到的商品库类型变化。您可根据/catalog/get/返回的catalog_type查看商品库的类型。目前支持 8 种类型的商品库：电商，酒店，航班，目的地、娱乐、汽车库存、汽车型号和短剧。 欲了解您可以向products中传入的参数，请查看下文的参数列表。
欲了解通过 JSON 结构向不同类型的商品库上传商品的步骤，请查看这里。
电商商品库支持的对象数组products参数
| 字段{30%} | 类型{15%} | 描述{55%} |
|---|---|---|
| products {必填} | object[] | 商品列表。 <br><br>最大数量：5,000。 |
#| sku_id {必填} | string | 商品的唯一 ID，例如 SKU。 <br><br>如果有相同 ID 的多个实例，这些实例将被忽略。如果要更新原始数据流中的同一商品，则需要使用相同的 ID 更换该商品。<br> 请只使用有效的 Unicode 字符，避免使用无效字符，如控制符或功能符。 <br>长度限制：100 字符，不能包含表情符号。<br> 示例：tiktok_item_1234。<br><p><span style="color:darkred"><b>注意</b></span>：不支持重复的 SKU ID。 |
#| title {必填} | string | 商品标题。 <br><br>请只使用有效的 Unicode 字符，避免使用无效字符，如控制符、功能符或表情符号。<br>请勿包含“免运费、高品质、批发价”等促销文案。<br>长度限制：500 字符，不能包含表情符号。 <br><br>示例：`T-Shirt (Unisex)`。 |
#| description {必填} | string | 关于商品的简短描述。<br>长度限制：10,000 字符。<br><br> 示例：`A vibrant crewneck for all shapes and sizes. Made from 100% cotton.` |
#| availability {必填} | string | 商店中该商品的当前库存情况。<br>枚举值：<ul><li> `IN_STOCK`：有库存。</li><li>`AVAILABLE_FOR_ORDER`：可订购。</li><li>`PREORDER`：可预订。</li><li>`OUT_OF_STOCK`：缺货。</li><li>`DISCONTINUED`：停售。</li></ul><br>示例：`IN_STOCK`。 |
#| brand {必填} | string | 商品品牌名称。<br><br> 长度限制：150 字符。 <br><br>示例：`TikTok`。 |
#| image_url {必填} | string | 商品主图的 URL。 <br><br>图片规格必须大于等于500x500像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。 <br>所有图片应为 JPG 或 PNG 格式。 <br>示例：`https://www.tiktok.com/t_shirt_image_001.jpg`。|
#| additional_image_urls | string[] | 商品的附加图片的 URL 列表。<br><br>最大数量：10。<br><br>图片规格必须大于等于500x500像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。 <br>所有图片应为 JPG 或 PNG 格式。 <br><br> 示例：`["https://www.tiktok.com/t_shirt_image_002.jpg","https://www.tiktok.com/t_shirt_image_003.jpg"]` 。<br><br><p><span style="color:darkred"><b>注意</b></span>：如果附加图片 URL 中包含逗号（,），需先对逗号进行 URL 编码，替换为 %2C，然后再将该 URL 传入此字段中。<br>例如，针对以下两个 URL：`https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp` 和<br>`https://img.example.com/product_800x600<b>,</b>q85<b>,</b>webp.jpg`，应将本字段设置为`["https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp","https://img.example.com/product_800x600<b>%2C</b>q85<b>%2C</b>webp.jpg"]`。|
#| video_url | string | 广告所使用视频的 URL。 <br><br>建议宽高比：9:16（竖版）；<br>建议用于 TikTok 的分辨率：≥720*1280；<br>建议用于 TikTok 的比特率：≥516kbps；<br>声音：已启用，包含字幕。<br> <br>示例： `https://www.tiktok.com/tiktok_t_shirt` 。 |
#| item_group_id | string | 商品 SPU ID。 <br><br>属于特定商品变化版本的商品。为所有变化版本的商品需提供相同的 `item_group_id`。例如，红色马球衫是马球衫的变化版本。 <br><br>示例：`TikTok_1234_sample`。 |
#| google_product_category | string | Google 商品类目中的预设值。<br><br>仅支持 3 个层级。<br>请参考 Google 网站： https://support.google.com/merchants/answer/6324436?hl=en <br><br>示例：`Apparel & Accessories> Clothing> Shirts`。 |
#| global_trade_item_number | string | 商品的全球贸易项目代码。 <br>示例：`3234567890126`。 |
#| manufacturer_part_number | string | 商品的制造商部件号。<br><br> 示例：`12433`。 |
#| product_detail {必填} | object | 商品的其他信息。 |
##| condition {必填} | string | 商店中商品的当前状况。 <br><br>枚举值： <ul><li>`NEW`：全新。</li><li>`REFURBISHED`：翻新。</li><li>`USED`：二手。</li></ul><br>示例： `NEW`。 |
##| age_group| string | 商品所适用的年龄组。为了确保向适当年龄的目标人群提供商品，请准确填写此字段。<br><br>枚举值：<ul><li>`NEW_BORN`：新生儿（0-3 个月）。</li><li> `INFANT`：婴儿（3-12 个月）。</li><li>`TODDLER`：幼儿（1-5 岁）。</li><li>`KIDS`：儿童（5-13 岁）。</li><li>`ADULT`：成人（13 岁或以上）。</li></ul><br>示例： `ADULT`。 |
##| color | string | 商品的颜色。<br><br>长度限制：100 字符。<br><br> 示例：`blue`。 |
##| gender | string | 商品的适用性别。为了确保向适当性别的目标人群提供商品，请准确填写 此字段。<br><br>枚举值：`MALE`（男性），`FEMALE`（女性），`UNISEX`（中性）。<br> <br>示例：`UNISEX`。 |
##| material | string | 商品的材质，如棉、牛仔布或皮革。<br><br>长度限制：200 字符。<br> <br>示例：`cotton`。 |
##| pattern | string | 商品上的图案或印刷图形。 <br><br>长度限制：100 字符。<br><br> 示例：`stripes1`。 |
##| product_category | string | 商品所属的类别。 <br><br>仅指明前 3 个层级。<br><br>示例：`Apparel & Accessories> Clothing> Shirts`。 |
##| shipping | string | 商品的运输类型。 <br><br>建议格式为：`COUNTRY:STATE:SHIPPING_TYPE: PRICE`（国家/地区:州/省:发货类型: 价格）。 <br> 示例：`US:CA:Ground:9.99 USD`。 |
##| shipping_weight | string | 商品重量。<br><br>支持的单位：`lb`，`oz`，`g`，`kg`。<br> <br>示例：`1 oz`，`1 kg`。 |
##| size | string | 商品尺寸。 <br><br>示例： `Small`，`Large`，`Extra Large`。 |
##| tax | string | 商品的税费。 |
#| price_info {必填} | object | 价格信息。 |
##| price {必填} | float | 商品的基础价格。<br><br>示例：30。 |
##| currency | string | 货币单位。 <br><br>若指定本字段，则需填入商品库所定向地域对应的币种。 <br> 若未指定本字段，则默认设置为商品库所定向地域对应的币种。 <br><br>示例：`USD`。 |
##| sale_price | float | 商品的促销价格（如果正在折价销售）。 <br><br>示例：20。 |
##| sale_price_effective_date | string | 促销开始和结束的日期及时间，格式为：`YYYY-MM-DDT23:59+00:00/YYYY-MM-DDT23:59+00:00`。<br> 开始日期应在结束日期之前。<br>如果商品的促销价没有限定期限，请不要传入本字段。<br><br> 示例：`2023-12-11T23:59+00:00/2023-12-15T23:59+00:00`。 |
#| landing_page {必填} | object | 落地页信息。 |
##| landing_page_url {必填} | string | 可浏览及购买该商品的落地页 URL。<br> <br>示例： `https://www.tiktok.com/tiktok_t_shirt` 。 |
##| ios_url | string | 作为 URL 的 iOS 应用自定义架构。对于 iOS，如果 iPhone 和 iPad 应用详情与普通 iOS 应用不同，请同时提供 iPhone 和 iPad 应用详情。<br><br> 示例：`iOS://electronic`。 |
##| ios_app_store_id | string | iOS 应用的 App Store ID。<br> <br>示例：`1234`。 |
##| ios_app_name | string | 要显示的 iOS 应用名称。 <br><br>示例：`Electronic iOS`。 |
##| iphone_app_store_id | string | iPhone 应用的 App Store ID。<br><br> 示例：`1234`。 |
##| iphone_app_name | string | 要显示的 iPhone 应用名称。<br><br> 示例：`Electronic iOS`。 |
##| ipad_app_store_id | string | iPad 应用的 App Store ID。<br><br> 示例：`1234`。 |
##| ipad_app_name | string | 要显示的 iPad 应用名称。 <br><br>示例：`Electronic iOS`。 |
##| android_url | string | 作为 URL 的 Android 应用自定义架构。<br><br> 示例：`android://electronic`。 |
##| android_package | string | Android 包的名称。 <br><br>示例：`com.electronic`。 |
##| android_app_name | string | 要显示的 Android 应用名称。 <br><br>示例：`Electronic Android`。 |
#| extra_info | object | 其他信息。 |
##| custom_label_0 | string | 您要添加的商品的其他相关信息。 <br>无长度限制。|
##| custom_label_1 | string | 您要添加的商品的其他相关信息。 <br>无长度限制。|
##| custom_label_2 | string | 您要添加的商品的其他相关信息。<br>无长度限制。|
##| custom_label_3 | string | 您要添加的商品的其他相关信息。<br> 无长度限制。|
##| custom_label_4 | string | 您要添加的商品的其他相关信息。 <br>无长度限制。|
酒店商品库支持的对象数组products参数
| 字段{30%} | 类型{15%} | 描述{55%} |
|---|---|---|
| products {必填} | object[] | 商品列表。<br><br>最大数量：5,000。 |
#| hotel_id {必填} | string | 酒店的唯一 ID。<br><br>长度限制：100 字符。 |
#| name {必填} | string | 酒店的名称。<br><br>长度限制：150 字符。 |
#| description | string | 酒店房间的简短描述。 <br><br>长度限制：10,000 字符。<br><br>示例：`Free Wifi, Free Breakfast, Free Cancellation`。 |
#| availability | string | 酒店的可用性。<br><br>枚举值：<ul><li>`IN_STOCK`：可预定。</li><li>`OUT_OF_STOCK`：不可预定。</li></ul><br>示例：`IN_STOCK`。 |
#| brand {必填} | string | 酒店品牌名称。 <br><br>长度限制：150 字符。 |
#| image_url {必填} | string | 酒店房间的主图片的 URL。 <br><br>图片规格必须大于等于500x500像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。 <br>所有图片应为 JPG 或 PNG 格式。<br> <br>示例： `https://www.tiktok.com/hotel_room_image_001.jpg`。 |
#| additional_image_urls | string[] | 酒店房间的附加图片的 URL。 <br><br>最大数量：20。 <br><br>图片规格必须大于等于500x500像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。 <br>所有图片应为 JPG 或 PNG 格式。 <br><br>示例：`["https://www.tiktok.com/hotel_room_image_002.jpg","https://www.tiktok.com/hotel_room_image_003.jpg"]` 。<br><br><p><span style="color:darkred"><b>注意</b></span>：如果附加图片 URL 中包含逗号（,），需先对逗号进行 URL 编码，替换为 %2C，然后再将该 URL 传入此字段中。<br>例如，针对以下两个 URL：`https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp` 和<br>`https://img.example.com/product_800x600<b>,</b>q85<b>,</b>webp.jpg`，应将本字段设置为`["https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp","https://img.example.com/product_800x600<b>%2C</b>q85<b>%2C</b>webp.jpg"]`。|
#| video_url | string | 广告所使用视频的 URL。 <br><br>建议宽高比：9:16（竖版）；<br>建议用于 TikTok 的分辨率：≥720*1280；<br>建议用于 TikTok 的比特率：≥516kbps；<br>声音：已启用，包含字幕。<br> <br>示例： `https://www.tiktok.com/hotel.mp4` 。 |
#| hotel_category | string[] | 酒店类别列表。<br><br>最大数量：3。<br><br>枚举值参阅 <a href="#item-link-hotel_category 可选值">`hotel_category` 可选值</a>。 |
#| hotel_retailer_id | string | 酒店零售商的唯一 ID。<br><br>长度限制：100 字符。 |
#| address {必填} | object | 地址信息。 |
##| address {必填} | string | 酒店主要街道地址的全称。 <br><br>长度限制：150 字符。 |
##| secondary_address | string | 酒店的次要街道地址。<br>长度限制：150 个字符。 |
##| tertiary_address | string | 酒店的三级街道地址。<br>长度限制：150 个字符。 |
##| city {必填} | string | 酒店所在城市。<br><br>长度限制：150 字符。 |
##| region | string | 酒店所在州/省。<br><br>长度限制：150 字符。 |
##| country {必填} | string | 酒店所在国家或地区。 <br><br>长度限制：150 字符。 |
#| neighborhood | string | 酒店所在社区。<br><br>长度限制：100 字符。<br><br> 示例：`Bangkok Old Town`。 |
#| postal_code | string | 酒店的邮政编码。<br>长度限制：150 个字符。 |
#| latitude | float| 酒店所在地的纬度。<br> <br>取值范围： [-90, 90]。<br><br>示例：37.484100。 |
#| longitude | float | 酒店所在地的经度。<br><br>取值范围：[-180, 180]。<br><br>示例： -122.148252。 |
#| margin_level | integer | 酒店按酒店房间的基础价格（`price`）上另外加收作为押金的比例。 <br><br>取值范围：[1, 10]。<br><br>例如，10 代表该酒店按酒店房间的基础价格的10%加收押金。 |
#| loyalty_program | string | 酒店提供的忠诚度计划。<br><br>枚举值参阅 <a href="#item-link-loyalty_program 可选值">`loyalty_program` 可选值</a>。 |
#| guest_ratings | object[] | 酒店的顾客评分信息。<br><br>最大数量：1。 |
##| rating_system | string | 酒店的评分系统。<br><br>长度限制：150 字符。 <br><br>示例：`Expedia`，`Tripadvisor`。|
##| max_score | integer | 该评分系统的最高评分。<br><br>取值范围： [0,100]。 |
##| score | float | 该酒店的实际评分。 <br><br>取值范围： ≥0。 |
##| number_of_reviewers | integer | 评价过该酒店的人数。 <br><br>取值范围： ≥0。 |
#| star_rating | integer | 由专业组织或旅游评论机构根据标准评定的酒店星级。最高评级通常为 5 星。上传此信息可能有助于提高页面浏览率。 |
#| room_type | string[] | 酒店房间类型列表。<br><br>枚举值参阅 <a href="#item-link-room_type 可选值">`room_type` 可选值</a>。<br><br>最大数量：3。 |
#| priority | integer | 酒店的优先级。<br><br>取值范围：0-5。<br>默认值：0。<br>值越高，代表优先级越高。 |
#| price_info {必填} | object | 价格信息。 |
##| price {必填} | float | 该酒店房间一晚的基础价格。 <br><br>示例：30。 |
##| currency | string | 货币单位。<br>若指定本字段，则需填入商品库所定向地域对应的币种。 <br>若未指定本字段，则默认设置为商品库所定向地域对应的币种。<br><br>示例：`USD`。 |
##| sale_price | float | 该酒店房间一晚的优惠价格。<br>`sale_price` 应低于 `price`。<br><br>示例：20。 |
#| landing_page | object | 落地页信息。 |
##| landing_page_url | string | 可浏览及购买该酒店的房间的落地页 URL。<br><br>示例： `https://www.tiktok.com/tiktok_hotel`。 |
##| ios_url | string | 作为 URL 的 iOS 应用自定义架构。对于 iOS，如果 iPhone 和 iPad 应用详情与普通 iOS 应用不同，请同时提供 iPhone 和 iPad 应用详情。<br><br> 示例：`iOS://electronic`。 |
##| ios_app_store_id | string | iOS 应用的 App Store ID。<br> <br>示例：`1234`。 |
##| ios_app_name | string | 要显示的 iOS 应用名称。 <br><br>示例：`Electronic iOS`。 |
##| android_url | string | 作为 URL 的 Android 应用自定义架构。<br><br> 示例：`android://electronic`。 |
##| android_package | string | Android 包的名称。 <br><br>示例：`com.electronic`。 |
##| android_app_name | string | 要显示的 Android 应用名称。 <br><br>示例：`Electronic Android`。 |
#| extra_info | object | 其他信息。 |
##| custom_label_0 | string | 您要添加的商品的其他相关信息。 <br> <br> 无长度限制。 |
##| custom_label_1 | string | 您要添加的商品的其他相关信息。 <br><br>无长度限制。 |
##| custom_label_2 | string | 您要添加的商品的其他相关信息。<br><br>无长度限制。 |
##| custom_label_3 | string | 您要添加的商品的其他相关信息。<br> <br>无长度限制。 |
##| custom_label_4 | string | 您要添加的商品的其他相关信息。 <br><br>无长度限制。 |
##| internal_label_0 | string | 分配给该酒店的内部标签。您可以使用这些内部标签在创建商品系列时筛选酒店。这些标签仅对您可见。<br><br>长度限制：100 个字符。<br><br>如果已在创建商品系列时使用自定义标签（`custom_label_0`到`custom_label_4`）来筛选酒店班，建议改用内部标签。内部标签与自定义标签不同，可以根据需要添加或修改，而无需每次提交酒店进行审核，避免广告投放的中断。 |
##| internal_label_1 | string | 分配给该酒店的内部标签。您可以使用这些内部标签在创建商品系列时筛选酒店。这些标签仅对您可见。<br><br>长度限制：100 个字符。<br><br>如果已在创建商品系列时使用自定义标签（`custom_label_0`到`custom_label_4`）来筛选酒店班，建议改用内部标签。内部标签与自定义标签不同，可以根据需要添加或修改，而无需每次提交酒店进行审核，避免广告投放的中断。 |
hotel_category 可选值
| 值{40%} | 描述 {60%}|
| --- | --- |
| `ACCOMMODATION` | 普通住宿 |
| `APARTMENT` | 公寓 |
| `BEACH_HOTEL` | 海滨酒店 |
| `BED_BREAKFAST` | 住宿加早餐 |
| `BOAT` | 船屋 |
| `CABIN` | 小木屋 |
| `CAMPING` | 露营地 |
| `CAPSULE_HOTEL` | 胶囊酒店 |
| `CASTLE` | 城堡 |
| `CHALET` | 小屋 |
| `CONDO` | 公寓住宅 |
| `CONDO_RESORT` | 公寓度假酒店 |
| `COTTAGE` | 乡村小屋 |
| `COUNTRY_HOUSE` | 乡村别墅 |
| `CRUISE` | 游轮 |
| `FAMILY_HOTEL` | 家庭酒店 |
| `FARM` | 农场 |
| `FARM_STAYS` | 农家乐 |
| `GUEST_HOUSE` | 客栈 |
| `HOLIDAY_PARK` | 假日公园 |
| `HOSTAL` | 旅店 |
| `HOSTEL` | 青年旅舍 |
| `HOSTEL_BACKPACKER_ACCOMMODATION` | 青年旅舍/背包客栈 |
| `HOTEL` | 酒店 |
| `HOUSEBOAT` | 船屋 |
| `INN` | 客栈 |
| `LODGE` | 小屋 |
| `LOVE_HOTELS` | 情趣酒店 |
| `LUXURY_TENT` | 豪华帐篷 |
| `MOTEL` | 汽车旅馆 |
| `PALACE` | 宫殿 |
| `PENSION` | 膳宿公寓 |
| `POUSADA` | 葡式旅馆 |
| `PRIVATE_VACATION_HOME` | 私人度假屋 |
| `RANCH` | 牧场 |
| `RESIDENCE` | 公馆 |
| `RESORT` | 度假村 |
| `RESORT_VILLAGES` | 度假村 |
| `RIAD` | 里亚德传统住宅 |
| `RYOKAN` | 日式旅馆 |
| `SAFARI` | 狩猎假期酒店 |
| `SERVICED_APARTMENT` | 服务式公寓 |
| `TOWNHOUSE` | 联排别墅 |
| `TREE_HOUSE` | 树屋 |
| `VILLA` | 别墅 |
loyalty_program 可选值
| 值{40%} | 描述 {60%}|
| --- | --- |
| `ACCOR_LIVE_LIMITLESS_ALL` | 雅高心悦界 |
| `AMAN_CLUB` | 安缦俱乐部 |
| `BANYAN_TREE_DISCOVERY` | 悦榕酒店 DISCOVERY |
| `BEST_WESTERN_REWARDS` | 倍优客会员俱乐部 |
| `CHOICE_PRIVILEGES` | 精选国际酒店集团会员计划 |
| `FOUR_SEASONS_LOYALTY_PROGRAM` | 四季酒店忠诚度计划 |
| `HILTON_HONORS` | 希尔顿荣誉客会 |
| `IHG_REWARDS_CLUB` | 洲际优悦会 |
| `KIMPTON_KARMA_REWARDS` | 金普顿优悦会奖励计划 |
| `LEADERS_CLUB_THE_LEADING_HOTELS_OF_THE_WORLD` | 立鼎世尊享贵宾会 |
| `LOEWS_LOVES_YOU` | Loews Loves You 计划 |
| `MARRIOTT_BONVOY` | 万豪旅享家 |
| `MOTEL_6_MY6` | 6 号汽车旅馆 My6 计划 |
| `RADISSON_REWARDS` | 丽赏会 |
| `SCANDIC_FRIENDS` | Scandic Friends 计划 |
| `SONESTA_TRAVEL_PASS` | 索尼斯塔酒店常旅客计划 |
| `TRUMP_CARD` | 川普酒店常客计划 |
| `WORLD_OF_HYATT` | 凯悦天地 |
| `WYNDHAM_REWARDS` | 温德姆奖赏计划 |
room_type 可选值
| 值{40%} | 描述 {60%}|
| --- | --- |
| `ACCESSIBLE_ROOM` | 无障碍客房 |
| `ALLERGY_FREE_ROOM` | 防过敏客房 |
| `APARTMENT_ROOM` | 公寓客房 |
| `APARTMENT_SUITE` | 公寓套房 |
| `ARTIST_ROOM` | 艺术家客房 |
| `BEACHFRONT_ROOM` | 海滨房 |
| `BUSINESS_ROOM` | 商务房 |
| `CABIN_ROOM` | 小屋客房 |
| `DELUXE_ROOM` | 豪华客房 |
| `DOUBLE_ROOM` | 双人房 |
| `DUPLEX_SUITE` | 双层套房 |
| `ECO_ROOM` | 生态客房 |
| `EXECUTIVE_ROOM` | 行政客房 |
| `EXECUTIVE_SUITE` | 行政套房 |
| `FAMILY_ROOM` | 家庭房 |
| `FITNESS_ROOM` | 健身房 |
| `FLOATING_ROOM` | 漂浮房 |
| `GARDEN_SUITE` | 花园套房 |
| `GARDEN_VIEW_ROOM` | 花园景观房 |
| `GLAMPING_TENT` | 豪华露营帐篷 |
| `GRAND_SUITE` | 特大套房 |
| `HISTORICAL_ROOM` | 历史主题房 |
| `HONEYMOON_SUITE` | 蜜月套房 |
| `JACUZZI_ROOM` | 按摩浴缸房 |
| `JUNIOR_SUITE` | 小型套房 |
| `LOFT_ROOM` | 夹层房 |
| `LOFT_SUITE` | 夹层套房 |
| `LUXURY_SUITE` | 奢华套房 |
| `MOUNTAIN_CHALET` | 山间小木屋 |
| `MOUNTAIN_LODGE` | 山间旅馆 |
| `MOUNTAIN_VIEW_ROOM` | 山景房 |
| `PENTHOUSE_SUITE` | 顶层套房 |
| `PET_FRIENDLY_ROOM` | 宠物友好房 |
| `POOL_VILLA_ROOM` | 游泳池别墅房 |
| `POOLSIDE_ROOM` | 池畔房 |
| `PRESIDENTIAL_SUITE` | 总统套房 |
| `PRIVATE_VILLA_ROOM` | 私人别墅房 |
| `ROMANTIC_SUITE` | 浪漫套房 |
| `RUSTIC_ROOM` | 乡村风格房 |
| `SEA_VIEW_ROOM` | 海景房 |
| `SINGLE_ROOM` | 单人房 |
| `SKI_IN_SKI_OUT_ROOM` | 便利滑雪房 |
| `SKI_ROOM` | 滑雪房 |
| `SOUNDPROOF_ROOM` | 隔音房 |
| `STUDIO_APARTMENT` | 单间公寓 |
| `STUDIO_ROOM` | 单间房 |
| `SUITE` | 套房 |
| `TERRACE_ROOM` | 露台房 |
| `TREEHOUSE_ROOM` | 树屋房 |
| `TWIN_ROOM` | 双床房 |
| `WATER_SUITE` | 水上套房 |
| `WELLNESS_ROOM` | 健康客房 |
航班商品库支持的对象数组products参数
| 字段{30%} | 类型{15%} | 描述{55%} |
|---|---|---|
| products {必填} | object[] | 商品列表。<br><br>最大数量：5,000。 |
#| origin_airport {必填} | string | 该航班的出发地机场。格式为三位字母的国际航空运输协会机场代码（IATA代码）。 <br><br>示例：`AAR`。<br><br><p><span style="color:darkred"><b>注意</b></span>: 同一个航班商品库中，不支持指定相同 `origin_airport` 和 `destination_airport` 的航班。</p> |
#| destination_airport {必填} | string | 该航班的目的地机场。格式为三位字母的国际航空运输协会机场代码。 <br><br>示例：`ABD`。<br><br><p><span style="color:darkred"><b>注意</b></span>: 同一个航班商品库中，不支持指定相同 `origin_airport` 和 `destination_airport` 的航班。</p> |
#| origin_city | string | 出发地城市。<br><br>长度限制：150 字符。 |
#| destination_city | string | 目的地城市。<br><br>长度限制：150 字符。 |
#| description | string | 该航班的简短描述。<br><br>长度限制：10,000 字符。 |
#| cabin_class | string | 该航班的客舱等级。 <br><br>枚举值：<ul><li>`FIRST_CLASS`: 头等舱。享受奢华设施与私人空间。</li><li>`FIRST_CLASS_SUITE`: 头等舱套间。提供私密套间及顶级豪华体验。</li><li>`BUSINESS_CLASS`: 商务舱。为商务和休闲旅客提供舒适与高品质设施。</li><li>`BUSINESS_CLASS_SUITE`: 商务舱套间。宽敞舒适的私人空间。</li><li>`COMFORT_CLASS`: 舒适舱。介于高档经济舱与经济舱之间的升级服务。</li><li>`ECONOMY_CLASS`: 经济舱。标准旅行配置与基础设施，价格实惠。</li><li>`BASIC_ECONOMY`: 基本经济舱。提供部分基础设施，经济实惠。</li><li>`STANDARD_ECONOMY`: 标准经济舱。提供基本服务和合理定价。</li><li>`PREMIUM_ECONOMY`: 高级经济舱。比标准经济舱有更多腿部空间和更好的机上服务。</li><li>`LIE_FLAT_SEAT`: 平躺座椅。提供长途航班的舒适平躺体验。</li><li>`CHARTER_CLASS`: 包机舱。私人飞机租赁，享有独特的旅行体验。</li><li>`ELITE_CLASS`: 会员舱。融合头等与商务舱的顶级服务。</li><li>`QUIET_CLASS`: 静音舱。噪音减弱区，提供宁静的飞行体验。</li></ul> |
#| airline_company | string | 运营该航班的航空公司的名称。 <br><br>枚举值：<ul><li>`AEROFLOT`: 俄罗斯航空。</li><li>`AIR_FRANCE_KLM_GROUP`: 法航-荷航集团。</li><li>`ALASKA_AIRLINES`: 阿拉斯加航空。</li><li>`ANA`: 全日空航空。</li><li>`AMERICAN_AIRLINES`: 美国航空。</li><li>`BRITISH_AIRWAYS`: 英国航空。</li><li>`CATHAY_PACIFIC`: 国泰航空。</li><li>`CHINA_SOUTHERN_AIRLINES`: 中国南方航空。</li><li>`CHINA_EASTERN_AIRLINES`: 中国东方航空。</li><li>`DELTA_AIR_LINES`: 达美航空。</li><li>`EMIRATES`: 阿联酋航空。</li><li>`JAPAN_AIRLINES`: 日本航空。</li><li>`JETBLUE_AIRWAYS`: 捷蓝航空。</li><li>`KLM_ROYAL_DUTCH_AIRLINES`: 荷兰皇家航空。</li><li>`LUFTHANSA_GROUP`: 汉莎航空集团。</li><li>`QANTAS_AIRWAYS`: 澳洲航空。</li><li>`QATAR_AIRWAYS`: 卡塔尔航空。</li><li>`SINGAPORE_AIRLINES`: 新加坡航空。</li><li>`SOUTHWEST_AIRLINES`: 西南航空。</li><li>`TURKISH_AIRLINES`: 土耳其航空。</li><li>`UNITED_AIRLINES`: 美国联合航空。</li><li>`VIRGIN_ATLANTIC`: 维珍航空。</li></ul>|
#| image_url {必填} | string | 航班的主图片的 URL。<br><br>图片规格必须大于等于500x500像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。 <br>所有图片应为 JPG 或 PNG 格式。 <br><br>示例： `https://www.tiktok.com/flight_image_001.jpg`。 |
#| additional_image_urls | string | 航班的附加图片的 URL。 <br><br>最大数量：20。 <br><br>图片规格必须大于等于500x500像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。 <br>所有图片应为 JPG 或 PNG 格式。 <br> <br>示例：`["https://www.tiktok.com/flight_image_002.jpg","https://www.tiktok.com/flight_image_003.jpg"]` 。<br><br><p><span style="color:darkred"><b>注意</b></span>：如果附加图片 URL 中包含逗号（,），需先对逗号进行 URL 编码，替换为 %2C，然后再将该 URL 传入此字段中。<br>例如，针对以下两个 URL：`https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp` 和<br>`https://img.example.com/product_800x600<b>,</b>q85<b>,</b>webp.jpg`，应将本字段设置为`["https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp","https://img.example.com/product_800x600<b>%2C</b>q85<b>%2C</b>webp.jpg"]`。|
#| video_url | string | 广告所使用视频的 URL。 <br><br>建议宽高比：9:16（竖版）；<br>建议用于 TikTok 的分辨率：≥720*1280；<br>建议用于 TikTok 的比特率：≥516kbps；<br>声音：已启用，包含字幕。<br> 示例： `https://www.tiktok.com/flight.mp4` 。 |
#| priority | integer | 航班的优先级。<br><br>取值范围：0-5。<br>默认值：0。<br>值越高，代表优先级越高。 |
#| price_info | object | 价格信息。 |
##| price | float | 该航班的基础价格。<br><br>示例： 3,000。 |
##| currency | string | 货币单位。 <br>若指定本字段，则需填入商品库所定向地域对应的币种。 <br>若未指定本字段，则默认设置为商品库所定向地域对应的币种。<br><br>示例：`USD`。 |
##| sale_price | float | 该航班的优惠价格。<br><br>`sale_price` 的值需小于 `price`。<br><br>示例： 2,500。 |
#| landing_page | object | 落地页信息。 |
##| landing_page_url | string | 可预定该航班的落地页 URL。<br><br>示例： `https://www.tiktok.com/tiktok_flight`。 |
##| ios_url | string | 作为 URL 的 iOS 应用自定义架构。对于 iOS，如果 iPhone 和 iPad 应用详情与普通 iOS 应用不同，请同时提供 iPhone 和 iPad 应用详情。<br><br> 示例：`iOS://electronic`。 |
##| ios_app_store_id | string | iOS 应用的 App Store ID。<br> <br>示例：`1234`。 |
##| ios_app_name | string | 要显示的 iOS 应用名称。 <br><br>示例：`Electronic iOS`。 |
##| android_url | string | 作为 URL 的 Android 应用自定义架构。<br><br> 示例：`android://electronic`。 |
##| android_package | string | Android 包的名称。 <br><br>示例：`com.electronic`。 |
##| android_app_name | string | 要显示的 Android 应用名称。 <br><br>示例：`Electronic Android`。 |
#| extra_info | object | 其他信息。 |
##| custom_label_0 | string | 您要添加的商品的其他相关信息。 <br> <br>无长度限制。|
##| custom_label_1 | string | 您要添加的商品的其他相关信息。 <br> <br>无长度限制。|
##| custom_label_2 | string | 您要添加的商品的其他相关信息。<br> <br>无长度限制。|
##| custom_label_3 | string | 您要添加的商品的其他相关信息。<br> <br>无长度限制。|
##| custom_label_4 | string | 您要添加的商品的其他相关信息。 <br> <br>无长度限制。|
##| internal_label_0 | string | 分配给该航班的内部标签。您可以使用这些内部标签在创建商品系列时筛选航班。这些标签仅对您可见。<br><br>长度限制：100字符。<br><br>如果已在创建商品系列时使用自定义标签（`custom_label_0`到`custom_label_4`）来筛选航班，建议改用内部标签。内部标签与自定义标签不同，可以根据需要添加或修改，而无需每次提交航班进行审核，避免广告投放的中断。|
##| internal_label_1 | string | 分配给该航班的内部标签。您可以使用这些内部标签在创建商品系列时筛选航班。这些标签仅对您可见。<br><br>长度限制：100字符。<br><br>如果已在创建商品系列时使用自定义标签（`custom_label_0`到`custom_label_4`）来筛选航班，建议改用内部标签。内部标签与自定义标签不同，可以根据需要添加或修改，而无需每次提交航班进行审核，避免广告投放的中断。|
目的地商品库支持的对象数组products参数
| 字段{30%} | 类型{15%} | 描述{55%} |
|---|---|---|
|products {必填} |object[] |商品列表。 <br> <br>最大数量：5,000。 |
#|destination_id {必填} |string |目的地的唯一 ID。 <br> <br>长度限制：100 字符。 |
#|destination_name {必填} |string |目的地的名称。 <br> <br>长度限制：150 字符。 |
#|description {必填} |string |目的地的简短描述。 <br> <br>长度限制：10,000 字符。 <br> <br>示例：`A visit to one of the most famous sights in London.`|
#|image_url {必填} |string |目的地的主图片的 URL。 <br> <br>图片规格必须大于等于500x500像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。 <br>所有图片应为 JPG 或 PNG 格式。 <br> <br>示例： `https://www.tiktok.com/hotel_room_image_001.jpg`。 |
#|additional_image_urls |string[] |目的地的附加图片的 URL。 <br> <br>最大数量：10。<br> <br>图片规格必须大于等于500x500像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。 <br>所有图片应为 JPG 或 PNG 格式。 <br> <br>示例：`["https://www.tiktok.com/destination_image_002.jpg","https://www.tiktok.com/destination_image_003.jpg"]` 。<br><br><p><span style="color:darkred"><b>注意</b></span>：如果附加图片 URL 中包含逗号（,），需先对逗号进行 URL 编码，替换为 %2C，然后再将该 URL 传入此字段中。<br>例如，针对以下两个 URL：`https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp` 和<br>`https://img.example.com/product_800x600<b>,</b>q85<b>,</b>webp.jpg`，应将本字段设置为`["https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp","https://img.example.com/product_800x600<b>%2C</b>q85<b>%2C</b>webp.jpg"]`。|
#| video_url | string | 广告所使用视频的 URL。 <br> <br>建议宽高比：9:16（竖版）；<br>建议用于 TikTok 的分辨率：≥720*1280；<br>建议用于 TikTok 的比特率：≥516kbps；<br>声音：已启用，包含字幕。<br> <br>示例： `https://www.tiktok.com/destination.mp4` 。 |
#|address {必填} |object |地址信息。 |
##|address {必填} |string |目的地的具体地址。 <br> <br>长度限制：150 字符。 |
##|city {必填} |string |目的地所在城市。 <br> <br>长度限制：150 字符。 |
##|region {必填} |string |目的地所在州/省。 <br> <br>长度限制：150 字符。 |
##|country {必填} |string |目的地所在国家或地区。<br> <br>长度限制：150 字符。 |
#| neighborhood | string | 目的地所在社区。<br><br>长度限制：100 字符。<br><br> 示例：`Bangkok Old Town`。 |
#|postal_code |string |目的地的邮政编码。 |
#|latitude |float |目的地的纬度。<br> <br>取值范围： [-90, 90]。 <br> <br>示例：37.484100 |
#|longitude |float |目的地的经度。<br> <br>取值范围：[-180, 180]。 <br> <br>示例： -122.148252 |
#|types {必填} |string[] |目的地的类型。<br> <br>您可为目的地指定一个或多个类型。例如，对于目的地纽约市，您可以将本字段设置为` ["city","sightseeing"]`。 <br> <br>最大数量：20。 |
#|price_info |object |价格信息。 |
##|price |float |目的地的平均价格或最低价格。 <br> <br>示例：30。 |
##|currency |string |货币单位。 <br>若指定本字段，则需填入商品库所定向地域对应的币种。 <br>若未指定本字段，则默认设置为商品库所定向地域对应的币种。 <br> <br>示例：`USD`。 |
##|sale_price |float |目的地的优惠价格。<br> <br>示例：20。 |
#|landing_page|object |落地页信息。 |
##|landing_page_url |string |可浏览该目的地的落地页 URL。 <br><br>示例： `https://www.tiktok.com/tiktok_destination`。 |
##| ios_url | string | 作为 URL 的 iOS 应用自定义架构。对于 iOS，如果 iPhone 和 iPad 应用详情与普通 iOS 应用不同，请同时提供 iPhone 和 iPad 应用详情。<br><br> 示例：`iOS://electronic`。 |
##| ios_app_store_id | string | iOS 应用的 App Store ID。<br> <br>示例：`1234`。 |
##| ios_app_name | string | 要显示的 iOS 应用名称。 <br><br>示例：`Electronic iOS`。 |
##| android_url | string | 作为 URL 的 Android 应用自定义架构。<br><br> 示例：`android://electronic`。 |
##| android_package | string | Android 包的名称。 <br><br>示例：`com.electronic`。 |
##| android_app_name | string | 要显示的 Android 应用名称。 <br><br>示例：`Electronic Android`。 |
#|extra_info |object |其他信息。 |
##|custom_label_0 |string |您要添加的商品的其他相关信息。<br><br>无长度限制。 |
##|custom_label_1 |string |您要添加的商品的其他相关信息。<br><br>无长度限制。 |
##|custom_label_2 |string |您要添加的商品的其他相关信息。 <br><br>无长度限制。 |
##|custom_label_3 |string |您要添加的商品的其他相关信息。 <br><br>无长度限制。 |
##|custom_label_4 |string |您要添加的商品的其他相关信息。<br><br>无长度限制。 |
娱乐商品库支持的对象数组products参数
注意
娱乐商品库目前在 Alpha 测试阶段，是仅向受邀开发者开放的白名单功能。如需使用此功能，请联系您的TikTok销售代表，但无法保证申请就能获得入选。
| 字段{30%} | 类型{15%} | 描述{55%} |
|---|---|---|
| products {必填} | object[] | 商品列表。<br><br>最大数量：5,000。 |
#| media_title_id {必填} | string | 媒体标题项的唯一 ID。<br><br>媒体标题项指可供发行或消费的媒体产品，例如电影、电视节目、音乐和体育比赛。<br><br>长度限制：100 字符。<br><br>示例：`TIKTOKLIVE001`。 |
#| title {必填} | string | 媒体标题项的名称。 <br><br>请只使用有效的 Unicode 字符，避免使用无效字符，如控制符、功能符或表情符号。<br><br>长度限制：150 字符。<br><br>示例：`TikTok LIVE Series`。 |
#| description | string | 媒体标题项的简短描述。 <br><br>长度限制：10,000 字符。 |
#| image_url {必填} | string | 媒体标题项的主图片的 URL。 <br>图片规格必须大于等于500 x 500 像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。 <br>所有图片应为 JPG 或 PNG 格式。 <br>示例：`https://www.tiktok.com/entertainment_image_001.jpg`。|
#| video_url | string | 广告所使用视频的 URL。 <br>建议宽高比：9:16（竖版）；<br>建议用于 TikTok 的分辨率：≥720*1280；<br>建议用于 TikTok 的比特率：≥516 kbps；<br>声音：已启用，包含字幕。<br> 示例： `https://www.tiktok.com/tiktok_live_series` 。 |
#| additional_image_urls | string[] | 媒体标题项的附加图片的 URL。<br>最大数量：20。<br>图片规格必须大于等于500x500像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。 <br>所有图片应为 JPG 或 PNG 格式。 <br> 示例：`["https://www.tiktok.com/entertainment_image_002.jpg","https://www.tiktok.com/entertainment_image_003.jpg"]` 。 <br><br><p><span style="color:darkred"><b>注意</b></span>：如果附加图片 URL 中包含逗号（,），需先对逗号进行 URL 编码，替换为 %2C，然后再将该 URL 传入此字段中。<br>例如，针对以下两个 URL：`https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp` 和<br>`https://img.example.com/product_800x600<b>,</b>q85<b>,</b>webp.jpg`，应将本字段设置为`["https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp","https://img.example.com/product_800x600<b>%2C</b>q85<b>%2C</b>webp.jpg"]`。|
#| genres | string[] | 媒体标题项的类型。 <br><br>若想获取本字段的允许值，请查看下文的“<a href="#item-link-genres可选值"> `genres`可选值</a>”小节。<br><br>最大数量：2。<br><br>示例： `TEEN`。 |
#| qid | string | 该媒体标题项在维基数据（Wikidata）上的唯一标识符 QID（或Q号码），由字母“Q”及其后的一个或多个数字组成。<br><br>长度限制：150 字符。<br><br>示例： `Q48938223`。 |
#|price_info |object |价格信息。 |
##|price |float |该媒体标题项的价格。 <br><br>示例：30。 |
##|currency |string |货币单位。 <br><br>若指定本字段，则需填入商品库所定向地域对应的币种。 <br><br>若未指定本字段，则默认设置为商品库所定向地域对应的币种。 <br><br>示例：`USD`。 |
#|landing_page |object |落地页信息。 |
##|landing_page_url |string |可浏览并购买该媒体标题项的落地页 URL。 <br><br>示例： `https://www.tiktok.com/tiktok_entertainment`。 |
##| ios_url | string | 作为 URL 的 iOS 应用自定义架构。对于 iOS，如果 iPhone 和 iPad 应用详情与普通 iOS 应用不同，请同时提供 iPhone 和 iPad 应用详情。<br><br> 示例：`iOS://electronic`。 |
##| ios_app_store_id | string | iOS 应用的 App Store ID。<br> <br>示例：`1234`。 |
##| ios_app_name | string | 要显示的 iOS 应用名称。 <br><br>示例：`Electronic iOS`。 |
##| android_url | string | 作为 URL 的 Android 应用自定义架构。<br><br> 示例：`android://electronic`。 |
##| android_package | string | Android 包的名称。 <br><br>示例：`com.electronic`。 |
##| android_app_name | string | 要显示的 Android 应用名称。 <br><br>示例：`Electronic Android`。 |
#|extra_info |object |其他信息。 |
##|custom_label_0 |string |您要添加的商品的其他相关信息。<br><br>无长度限制。|
##|custom_label_1 |string |您要添加的商品的其他相关信息。<br><br>无长度限制。|
##|custom_label_2 |string |您要添加的商品的其他相关信息。 <br><br>无长度限制。|
##|custom_label_3 |string |您要添加的商品的其他相关信息。 <br><br>无长度限制。|
##|custom_label_4 |string |您要添加的商品的其他相关信息。<br><br>无长度限制。|
genres可选值
| 值 {30%}| 描述{60%} |
|---|---|
| `ACTION` | 动作 |
| `ADULT_ANIMATION` | 成人动画 |
| `ADVENTURE` | 冒险 |
| `ANIMATION` | 动画 |
| `BIOGRAPHICAL` | 传记 |
| `BLACK_COMEDY` | 黑色喜剧 |
| `BUDDY` | 好友 |
| `COMEDY` | 喜剧 |
| `COMIC` | 漫画 |
| `COOKING_SHOW` | 烹饪节目 |
| `CRIME` | 犯罪 |
| `DISASTER` | 灾难 |
| `DOCUMENTARY` | 纪录片 |
| `DRAMA` | 剧情 |
| `FAMILY` | 家庭 |
| `FANTASY` | 奇幻 |
| `GAME_SHOW` | 游戏节目 |
| `HISTORY` | 历史 |
| `HORROR` | 恐怖 |
| `LGBT` | LGBT|
| `MARTIAL_ARTS` | 武术 |
| `MILITARY` | 战争 |
| `MUSIC` | 音乐 |
| `POLICE` | 警察 |
| `POLICE_PROCEDURAL` | 警匪片 |
| `POLITIC` | 政治 |
| `REALITY_TV` | 真人秀 |
| `ROAD` | 公路 |
| `ROMANCE` | 浪漫 |
| `SATIRE` | 讽刺 |
| `SCIENCE_FICTION` | 科幻 |
| `SITCOM` | 情景喜剧 |
| `SOAP_OPERA` | 肥皂剧 |
| `SPORT` | 体育 |
| `SPY` | 间谍 |
| `STEAMPUNK` | 蒸汽朋克 |
| `SUPERHERO` | 超级英雄 |
| `TALK_SHOW` | 脱口秀 |
| `TEEN` | 青少年 |
| `THRILLER` | 惊悚 |
| `TIME_TRAVEL` | 时间旅行 |
| `VAMPIRE` | 吸血鬼 |
| `WAR` | 战争 |
| `WESTERN` | 西部 |
| `ZOMBIE` | 僵尸 |
汽车库存商品库支持的对象数组 products 参数
|字段{30%}|数据类型{15%}|描述{55%}|
|---|---|---|
|products {必填}|object[]|要上传的车辆列表。<br><br>最大数量：5,000。|
#|vehicle_id {必填}|string|车辆的唯一 ID。<br><br>长度限制：100 个字符。<br><br>示例：`TIKTOKMOTORSSEDAN001`。|
#|title {必填}|string|车辆的名称。<br><br>仅使用有效的 Unicode 字符，避免使用控制字符、功能字符或表情符号等无效字符。<br><br>长度限制：500 个字符。<br><br>示例：`TikTok Motors Sedan`。|
#|description {必填}|string|车辆的简短描述。<br><br>长度限制：5,000 个字符。<br><br>示例：`Experience the ultimate luxury and performance with the TikTok Motors Sedan.`|
#|availability|string|车辆的当前库存情况。<br><br>枚举值：<ul><li>`AVAILABLE`：有货。</li><li>`NOT_AVAILABLE`：无货。</li></ul>示例：`AVAILABLE`。|
#|image_url {必填}|string|车辆图片的 URL，格式为 `http://xxx` 或 `https://xxx`。<br><br>图片规格必须大于等于 500 x 500 像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。<br><br>所有图片应为 JPG 或 PNG 格式。<br><br>示例：`https://www.tiktok.com/auto_vehicle_image_001.jpg`。|
#|additional_image_urls|string[]|车辆的附加图片的 URL，格式为 `http://xxx` 或 `https://xxx`。<br><br>最大数量：20。<br><br>图片规格必须大于等于 500x500 像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](https://ads.tiktok.com/marketing_api/docs?id=1739578479392770)。<br><br>所有图片应为 JPG 或 PNG 格式。<br><br>示例：`["https://www.tiktok.com/auto_vehicle_image_002.jpg","https://www.tiktok.com/auto_vehicle_image_003.jpg"]`。<br><br><p><span style="color:darkred"><b>注意</b></span>：如果附加图片 URL 中包含逗号（,），需先对逗号进行 URL 编码，替换为 %2C，然后再将该 URL 传入此字段中。<br>例如，针对以下两个 URL：`https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp` 和 `https://img.example.com/product_800x600<b>,</b>q85<b>,</b>webp.jpg`，应将本字段设置为 `["https://img.example.com/product.jpg?width=800&height=600&quality=85&format=webp","https://img.example.com/product_800x600<b>%2C</b>q85<b>%2C</b>webp.jpg"]`。|
#| video_url | string | 广告所使用视频的 URL。<br><br>建议宽高比：9: 16（竖版）。<br>建议用于 TikTok 的分辨率：≥720 * 1280。<br>建议用于 TikTok 的比特率：≥516 kbps。<br>声音：已启用，包含字幕。<br>支持格式：.mp4、.mov、.avi。<br>最大文件大小：100 MB。<br>推荐时长：15-60 秒。<br><br>示例：`https://www.tiktok.com/auto_inventory.mp4`。 |
#|product_detail|object|有关车辆的其他信息。|
##|condition|string|车辆的当前状况。<br><br>枚举值：<ul><li>`EXCELLENT`：优秀。</li><li>`GOOD`：良好。</li><li>`FAIR`：一般。</li><li>`POOR`：较差。</li><li>`OTHER`：其他。</li></ul>示例：`GOOD`。|
##|offer_type | string | 优惠类型。<br><br>长度限制：100 个字符。<br><br>推荐值：<ul><li>`CASH`：现金优惠，买家预付全款并立即获得汽车所有权。</li><ul><li>您可以使用 `amount_price` 指定现金优惠的价格。</li><ul><li>例如，若现金优惠为 36,838 USD，您可以将 `amount_price` 设置为 `36838`。</li></ul></ul><li>`LEASE`：租赁优惠，买家按月支付在规定期限内使用车辆的费用。除非选择买断，否则租赁期满后买家不会自动拥有汽车。</li><ul><li>您可以使用 `term_length`、`offer_term_qualifier`、`amount_price`、`amount_qualifier`、`downpayment` 和 `downpayment_qualifier` 指定租赁优惠的期限、月付和首付。</li><ul><li>例如，若租赁优惠为每月 486 USD，为期三年，签约时需支付 2,986 USD，则可将 `term_length` 设置为 `3`、`offer_term_qualifier` 设置为 `years`、`amount_price` 设置为 `486`、`amount_qualifier` 设置为 `month`、`downpayment` 设置为 `2986`，`downpayment_qualifier` 设置为 `due at signing`。</li></ul></ul><li>`FINANCE`：金融优惠，买家借款购买汽车，并在固定期限内分期偿还。买家在付清所有贷款后拥有汽车。</li><ul><li>您可以使用 `term_length`、`offer_term_qualifier`、`amount_price`、`amount_percentage` 和 `amount_qualifier` 指定金融优惠的期限、价格和年利率（APR，借款收取的年利率）。</li><ul><li>例如，若金融优惠总额为 37,170 USD，需在 60 个月内付清，年利率为 5.25%，则可将 `term_length` 设置为 `60`、`offer_term_qualifier` 设置为 `months`、`amount_price` 设置为 `37170`、`amount_percentage` 设置为 `5.25%`，以及 `amount_qualifier` 设置为 `APR`。</li></ul></ul></ul> |
##|term_length | string | 优惠适用的期限。<br><br>`term_length` 和 `offer_term_qualifier` 的组合共同定义了优惠的总适用期限。<br><br>长度限制：100 个字符。<br><br>示例：`3`。 |
##|offer_term_qualifier | string | 优惠的期限单位。<br><br>推荐值：`months`、`years`。<br><br>长度限制：100 个字符。 |
##|amount_price | string | 优惠的金额。<br><br><ul><li>对于现金和租赁优惠，您可以使用 `amount_price` 指定月付款，并将 `amount_qualifier` 设置为 `month`。</li><li>对于金融优惠，您可以使用 `amount_price` 指定总价，使用 `amount_percentage` 指定年利率。将 `amount_qualifier` 设置为 `APR`。</li></ul><br>示例：`100`。<br><br>`amount_price` 的币种将是商品库的 `currency`。如需获取商品库的币种，请使用 [/catalog/get/](1740315452868610.html)。 |
##|amount_percentage | string | 金融优惠中 APR（年利率）的百分比。<br><br>示例：`1.1%`。<br><br>长度限制：100 个字符。 |
##|amount_qualifier | string | `amount_price` 或 `amount_percentage` 的单位。<br><br>示例：`month`（每月），`APR`（年利率）。<br><br>长度限制：100 个字符。<br><br><ul><li>对于现金和租赁优惠，您可以将此字段设置为 `month`，并使用 `amount_price` 指定月付款。</li><li>对于金融优惠，您可以将此字段设置为 `APR`，并使用 `amount_percentage` 指定 APR 百分比。使用 `amount_price` 指定总价。</li></ul> |
##|downpayment | string | 购买或租赁时的首付款。<br><br>示例：`3000`。<br><br>`downpayment` 的币种将是商品库的 `currency`。如需获取商品库的币种，请使用 [/catalog/get/](1740315452868610.html)。 |
##|downpayment_qualifier | string | 首付款的单位。<br><br>示例：`due at signing`。<br><br>长度限制：100 个字符。 |
##|offer_disclaimer | string | 应用内弹窗中显示的优惠广告免责声明全文。<br><br>长度限制：5,000 个字符。 |
##|offer_disclaimer_url | string | 优惠广告免责声明 URL，将用户导向与优惠广告免责声明相关的其他信息的 URL，格式为 `http://xxx` 或 `https://xxx`。<br><br>示例：`https://www.tiktok.com/tiktok_auto_inventory_disclaimer`。 |
##|emission_disclaimer | string | 应用内弹窗中显示的碳排放免责声明全文。<br><br>长度限制：5,000 个字符。 |
##|emission_disclaimer_url | string | 碳排放免责声明 URL，将用户导向与碳排放免责声明相关的其他信息的 URL，格式为 `http://xxx` 或 `https://xxx`。<br><br>示例：`https://www.tiktok.com/tiktok_auto_inventory_emission_disclaimer`。 |
##|emission_overlay_disclaimer | string | 碳排放免责声明摘要，在免责声明横幅上显示的免责声明短文本。<br><br>长度限制：500 个字符。 |
##|emission_image_link | string | 碳排放图片，显示碳排放水平的图片链接，格式为 `http://xxx` 或 `https://xxx`。<br><br>图片尺寸必须为 450 x 450 像素或以上。<br><br>文件大小限制：4 MB 以内。<br><br>示例：`https://www.tiktok.com/tiktok_auto_inventory_emission_image.jpg` |
#|state_of_vehicle {必填}|string|车辆状态。<br><br>枚举值：<ul><li>`NEW`：全新。</li><li>`USED`：二手。</li><li>`CPO`：CPO（认证二手车）。CPO 汽车是经过全面检查的二手车，与普通二手车相比，通常更新、里程更低，并附带额外的保修范围。</li></ul>示例：`USED`。|
#|vehicle_type|string|车辆类型。<br><br>枚举值：<ul><li>`BOAT`：船。</li><li>`CAR_TRUCK`：汽车/卡车。</li><li>`COMMERCIAL`：商用车，即用于商业目的的汽车，如送货卡车。</li><li>`MOTORCYCLE`：摩托车。</li><li>`POWERSPORT`：动力运动汽车。专为户外活动和探险设计的休闲车，如雪地摩托。</li><li>`RV_CAMPER`：房车/露营车，专为旅行和露营目的设计的休闲车或露营车。</li><li>`TRAILER`：拖车。</li><li>`OTHER`：以上未涵盖的任何其他车辆类型。</li></ul>|
#|make {必填}|string|车辆的品牌。<br><br>长度限制：100 个字符。<br><br>示例：`TikTok Motors`。|
#|model {必填}|string|车辆的型号。<br><br>长度限制：100 个字符。<br><br>示例：`X`。|
#|trim|string|车辆的内饰。内饰代表了该型号特有的规格包。<br><br>长度限制：50 个字符。<br><br>示例：`Long Range`。|
#|year {必填}|integer|车辆的年份，格式为 `YYYY`。<br><br>取值范围：1801-2999。<br><br>示例：`2023`。|
#|vin|string|车辆的 VIN（车辆识别码）。<br><br>根据 ISO 3779 标准，自 1981 年以来生产的车辆的 VIN 必须是 17 位字母数字代码。<br><br>长度限制：17 个字符。<br><br>示例：`1TIKT0K5TAR123456`。|
#|mileage {必填}|object|车辆的里程。|
##|value {必填}|integer|里程值。<br><br>取值范围：≥0。|
##|unit {必填}|string|里程单位。<br><br>枚举值：<ul><li>`MILE`：英里。</li><li>`KILOMETER`：千米。</li></ul>|
#|body_style {必填}|string|车辆的车身款式。<br><br>枚举值：<ul><li>`CONVERTIBLE`：敞篷车。</li><li>`COUPE`：双门轿车。</li><li>`CROSSOVER`：跨界车。</li><li>`HATCHBACK`：掀背车。</li><li>`MINIVAN`：小型面包车。</li><li>`SMALL_CAR`：小型车。</li><li>`SEDAN`：轿车。</li><li>`SUV`：越野车。</li><li>`TRUCK`：卡车。</li><li>`VAN`：面包车。</li><li>`WAGON`：旅行车。</li><li>`OTHER`：其他。</li></ul>|
#|exterior_color {必填}|string|车辆的车身颜色。<br><br>长度限制：100 个字符。|
#|interior_color|string|车辆的内饰颜色。<br><br>长度限制：100 个字符。|
#|transmission|string|车辆的变速箱类型。<br><br>枚举值：<ul><li>`AUTOMATIC`：自动。</li><li>`MANUAL`：手动。</li></ul>|
#|drivetrain|string|车辆的传动系统类型。<br><br>枚举值：<ul><li>`4X2`：4X2，四轮驱动汽车，带两轮驱动。传动系统为前轮或后轮提供动力。</li><li>`4X4`：4X4，四轮驱动汽车，带四轮驱动。传动系统为所有四个车轮提供动力。</li><li>`AWD`：AWD，全轮驱动。传动系统持续为所有车轮提供动力。</li><li>`FWD`：FWD，前轮驱动。传动系统仅为前轮提供动力。</li><li>`RWD`：RWD，后轮驱动。传动系统仅为后轮提供动力。</li><li>`OTHER`：以上未涵盖的任何其他传动系统类型，例如具有独特传动系统样式的电动汽车。</li></ul>|
#|fuel_type|string|车辆的燃料类型。<br><br>枚举值：<ul><li>`DIESEL`：柴油。</li><li>`ELECTRIC`：电动。</li><li>`FLEX`：双燃料，汽油和乙醇的混合物。</li><li>`GASOLINE`：汽油。</li><li>`HYBRID`：混动。</li><li>`OTHER`：其他。</li></ul>|
#|address {必填}|object|经销商的地址信息。<br><br>商品库的定向地域将用作经销商的默认地域。|
##|address {必填}|string|经销商的地址。<br><br>长度限制：150 个字符。|
##|city {必填}|string|经销商所在的城市。<br><br>长度限制：150 个字符。|
##|region {必填}|string|经销商所在的地区（州或省）。<br><br>长度限制：150 个字符。|
##|postal_code {必填}|string|经销商地址的邮政编码。<br><br>长度限制：150 个字符。|
#|latitude {必填}|float|经销商地址的纬度。<br><br>取值范围：[-90, 90]。<br><br>示例：37.484100|
#|longitude {必填}|float|经销商地址的经度。<br><br>取值范围：[-180, 180]。<br><br>示例：-122.148252|
#|dealer|object|经销商的详细信息。|
##|dealer_id|string|经销商的唯一 ID。<br><br>长度限制：100 个字符。|
##|dealer_name|string|经销商的名称。<br><br>长度限制：100 个字符。|
##|dealer_phone|string|经销商的电话号码。<br><br>确保号码包含国家电话区号。<br><br>长度限制：15 个字符。|
##|stock_number|string|经销商为车辆分配的库存编号。库存编号通常在车辆实际到达经销商场地时分配。<br><br>长度限制：100 个字符。<br><br>示例：`T12345`。|
#|date_first_on_lot|string|销售天数，车辆实际到达经销商场地的日期，格式为 `YYYY-MM-DD`。<br><br>示例：`2023-12-01`。|
#|days_on_lot|integer|起售日期，车辆在经销商场地的天数。<br><br>您可以通过计算 `date_first_on_lot` 与当前日期之间的差值来得出此值。请注意，此字段不会每天自动递增。如果指定此字段，建议每天更新以确保信息准确。<br><br>默认值：0。<br><br>示例：13。|
#|price_info {必填}|object|价格信息。|
##|price {必填}|float|车辆的价格。<br><br>示例：9.9。|
##|currency|string|币种单位。<br><br>若指定本字段，则需填入商品库所定向地域对应的币种。<br><br>若未指定本字段，则默认设置为商品库所定向地域对应的币种。<br><br>示例：`USD`。|
##|sale_price|float|车辆促销时的促销价。<br><br>此字段的值应小于 price 的值。<br><br>示例：9.9。|
##|sale_price_effective_date|string|促销的开始和结束日期和时间，格式为 `YYYY-MM-DDT23:59+00:00/YYYY-MM-DDT23:59+00:00`。<br><br>开始日期应早于结束日期。如果产品的促销价永久有效，请勿传入此字段。<br><br>示例：`2023-12-11T23:59+00:00/2023-12-15T23:59+00:00`。|
#|landing_page {必填}|object|落地页信息。|
##|landing_page_url {必填}|string|可以查看和购买车辆的落地页 URL。<br><br>示例：`https://www.tiktok.com/tiktok_auto_inventory`。|
##|ios_url|string|作为 URL 的 iOS 应用自定义架构。<br><br>示例：`iOS://electronic`|
##|android_url|string|作为 URL 的 Android 应用自定义架构。<br><br>示例：`android://electronic`|
#|extra_info|object|附加信息。|
##|custom_label_0|string|您要添加的商品的其他相关信息。<br><br>无长度限制。|
##|custom_label_1|string|您要添加的商品的其他相关信息。<br><br>无长度限制。|
##|custom_label_2|string|您要添加的商品的其他相关信息。<br><br>无长度限制。|
##|custom_label_3|string|您要添加的商品的其他相关信息。<br><br>无长度限制。|
##|custom_label_4|string|您要添加的商品的其他相关信息。<br><br>无长度限制。|
汽车型号商品库支持的对象数组 products 参数
|字段{30%}|数据类型{15%}|描述{55%}|
|---|---|---|
|products {必填}|object[]|您要上传的车辆列表。<br><br>最大数量：5,000。|
#|vehicle_id {必填}|string|车辆的唯一 ID。<br><br>长度限制：100 个字符。<br><br>示例：`TIKTOKMOTORSX001`。|
#|title {必填}|string|车辆的名称。<br><br>如果适用，请包括品牌、型号、配置和年份的详细信息。<br><br>仅使用有效的 Unicode 字符，避免使用控制字符、功能字符或表情符号等无效字符。<br><br>推荐长度：40 个字符以内。<br>长度限制：128 个字符。<br><br>示例：`2025 TikTok Motors X Long Range`。|
#|image_url {必填}|string|车辆图片的 URL，格式为 `http://xxx` 或 `https://xxx`。<br><br>图片尺寸必须为 450 x 450 像素或以上。小于此分辨率的图片将被过滤，商品无法通过审核。<br>所有图片均应为 JPG、PNG 或 JPEG 格式。<br>文件大小限制：4 MB 以内。<br><br>示例：`https://www.tiktok.com/auto_model_image_001.jpg`。|
#| video_url | string | 广告所使用视频的 URL。<br><br>建议宽高比：9:16（竖版）。<br>建议用于 TikTok 的分辨率：≥ 720 * 1280。<br>建议用于 TikTok 的比特率：≥ 516 kbps。<br>声音：已启用，包含字幕。<br>支持格式：.mp4、.mov、.avi。<br>最大文件大小：100 MB。<br>推荐时长：15-60 秒。<br><br>示例：`https://www.tiktok.com/auto_model.mp4`。 |
#|make {必填}|string|车辆的品牌。<br><br>长度限制：100 个字符。<br><br>示例：`TikTok Motors`。|
#|model {必填}|string|车辆的型号。<br><br>长度限制：100 个字符。<br><br>示例：`X`。|
#|trim|string|车辆的内饰。内饰代表了该型号特有的规格包。<br><br>长度限制：50 个字符。<br><br>示例：`Long Range`。|
#|year {必填}|integer|车辆的年份，格式为 `YYYY`。<br><br>示例：2025。|
#|exterior_color {必填}|string|车辆的车身颜色。<br><br>长度限制：100 个字符。<br><br>示例：`Black`。|
#|product_detail|object|有关车辆的其他信息。|
##|offer_type|string|优惠类型。<br><br>长度限制：100 个字符。<br><br>推荐值：<ul><li>`CASH`：现金优惠，买家预付全款并立即获得汽车所有权。<ul><li>您可以使用 `amount_price` 指定现金优惠的价格。<br>例如，若现金优惠为 36,838 美元，您可以将 `amount_price` 设置为 `36838`。</li></ul></li><li>`LEASE`：租赁优惠，买家按月支付在规定期限内使用车辆的费用。除非选择买断，否则租赁期满后买家不会自动拥有汽车。<ul><li>您可以使用 `term_length`、`offer_term_qualifier`、`amount_price`、`amount_qualifier`、`downpayment` 和 `downpayment_qualifier` 指定租赁优惠的期限、月付和首付。<br>例如，若租赁优惠为每月 486 美元，为期三年，签约时需支付 2,986 美元，则可将 `term_length` 设置为 `3`、`offer_term_qualifier` 设置为 `years`、`amount_price` 设置为 `486`、`amount_qualifier` 设置为 `month`、`downpayment` 设置为 `2986`，`downpayment_qualifier` 设置为 `due at signing`。</li></ul></li><li>`FINANCE`：金融优惠，买家借款购买汽车，并在固定期限内分期偿还。买家在付清所有贷款后拥有汽车。<ul><li>您可以使用 `term_length`、`offer_term_qualifier`、`amount_price`、`amount_percentage` 和 `amount_qualifier` 指定金融优惠的期限、价格和年利率（APR，借款收取的年利率）。<br>例如，若金融优惠总额为 37,170 美元，需在 60 个月内付清，年利率为 5.25%，则可将 `term_length` 设置为 `60`、`offer_term_qualifier` 设置为 `months`、`amount_price` 设置为 `37170`、`amount_percentage` 设置为 `5.25%`，以及 `amount_qualifier` 设置为 `APR`。</li></ul></li></ul>|
##|term_length|string|优惠适用的期限。<br><br>`term_length` 和 `offer_term_qualifier` 的组合共同定义了优惠的总适用期限。<br><br>长度限制：100 个字符。<br><br>示例：`3`。|
##|offer_term_qualifier|string|优惠的期限单位。<br><br>推荐值：`months`、`years`。<br><br>长度限制：100 个字符。|
##|amount_price|string|优惠的金额。<br><br>示例：`100`。<br><br>`amount_price` 的币种将是商品库的 currency。如需获取商品库的币种，请使用 [/catalog/get/](1740315452868610.html)。|
##|amount_percentage|string|金融优惠中 APR（年利率）的百分比。<br><br>示例：`1.1%`。<br><br>长度限制：100 个字符。|
##|amount_qualifier|string|`amount_price` 或 `amount_percentage` 的单位。<br><br>示例：`month`（每月），`APR`（年利率）。<br><br>长度限制：100 个字符。<ul><li>对于现金和租赁优惠，您可以将此字段设置为 `month`，并使用 `amount_price` 指定月付款。</li><li>对于金融优惠，您可以将此字段设置为 `APR`，并使用 `amount_percentage` 指定 APR 百分比。使用 `amount_price` 指定总价。</li></ul>|
##|downpayment|string|购买或租赁时的首付款。<br><br>示例：`3000`。<br><br>`downpayment` 的币种将是商品库的 `currency`。如需获取商品库的币种，请使用 [/catalog/get/](1740315452868610.html)。|
##|downpayment_qualifier|string|首付款的单位。<br><br>示例：`due at signing`。<br><br>长度限制：100 个字符。|
##|offer_disclaimer|string|应用内弹窗中显示的优惠广告免责声明全文。<br><br>长度限制：5,000 个字符。|
##|offer_disclaimer_url|string|一个将用户导向与优惠广告免责声明相关的其他信息的 URL，格式为 `http://xxx` 或 `https://xxx`。<br><br>示例：`https://www.tiktok.com/tiktok_auto_model_disclaimer`。|
##|emission_disclaimer|string|应用内弹窗中显示的碳排放免责声明全文。<br><br>长度限制：5,000 个字符。|
##|emission_disclaimer_url|string|一个将用户导向与碳排放免责声明相关的其他信息的 URL，格式为 `http://xxx` 或 `https://xxx`。<br><br>示例：`https://www.tiktok.com/tiktok_auto_model_emission_disclaimer`。|
##|emission_overlay_disclaimer|string|在免责声明横幅上显示的免责声明短文本。<br><br>长度限制：500 个字符。|
##|emission_image_link|string|显示碳排放水平的图片链接，格式为 `http://xxx` 或 `https://xxx`。<br><br>图片尺寸必须为 500 x 500 像素或以上。<br><br>文件大小限制：4 MB 以内。<br><br>示例：`https://www.tiktok.com/tiktok_auto_model_emission_image.jpg`。|
#|landing_page {必填}|string|落地页信息。|
##|landing_page_url {必填}|string|可以查看车辆列表的落地页 URL。<br><br>示例：`https://www.tiktok.com/tiktok_auto_model`。|
短剧商品库支持的对象数组products参数
注意
短剧商品库目前在测试阶段，是仅向受邀开发者开放的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表，但无法保证申请就能入选。
| 字段 {30%}| 类型 {15%}| 描述 {55%}|
|---|---|---|
|products {必填} |object[] |短剧列表。<br><br>最大数量：5,000。|
#|series_id {必填}|string|短剧的自定义唯一 ID。<br><br>长度限制：100 字符。|
#|series_name {必填}|string|短剧名称。<br><br>长度限制：100 字符。|
#|target_config|object|短剧的定向详情。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>如需将定向多个地域的短剧上传至短剧商品库，需多次调用 [/catalog/product/upload/](1740497429681153.html) 接口并传入相同的 `series_id` 和不同的 `target_config` 。上传后，可以通过 [/catalog/product/get/](1740564136678402.html) 接口中的 `target_config` 和 `additional_product_list` 获取同一短剧的合并后的定向设置。<br>例如，如果将`target_config` 分别设置为 `{"region_code": "US"}`（即短剧商品库的主要定向地域）和 `{"region_code": "VN"}`（即短剧商品库的一个额外定向地域）从而上传两次短剧，则[/catalog/product/get/](1740564136678402.html) 接口返回的 `list.target_config.region_code` 将为 `US`，`list.additional_product_list.region_code` 将为 `VN`。</li></ul>|
##|region_code|string|短剧的定向地区代码。<br><br>该地域应为短剧商品库的主要或额外定向地域的子集。<br><br>如需获取短剧商品库的定向地域，可使用 [/catalog/get/](1740315452868610.html) 接口。`catalog_conf` 对象中的 `region_code` 代表主要定向地域，`additional_config_list` 包含额外定向地域。<br><br>示例: `US`。|
#|image_url {必填}|string|短剧封面图的 URL。<br><br>图片规格必须大于等于500 x 500像素，否则图片将被过滤，商品无法通过审核。详细信息请参考[商品图片要求](1739578479392770.html)。<br>所有图片应为 JPG 或 PNG 格式。<br><br>示例： `https://www.tiktok.com/short_drama_series_image_001.jpg`。|
#| video_url | string | 广告中使用的视频 URL。<br><br>建议视频宽高比为 9:16（竖屏）。<br>TikTok 广告位建议分辨率：≥ 720 * 1280。<br>TikTok 广告位建议比特率：≥ 516 kbps。<br>声音：开启并配备字幕。<br>支持的格式：.mp4、.mov、.avi。<br>文件大小上限：100 MB。<br>建议时长：15-60 秒。<br><br>示例：`https://www.tiktok.com/short_drama_series.mp4`。|
#|recharge {必填}|object[]|短剧收费详情。|
##|type {必填}|string|短剧收费类型。<br><br>枚举值：<ul><li>`BY_TIERS`: 按级别收费。</li><li>`SUBSCRIPTION`: 按周期订阅收费。</li><li>`BY_EPISODES`: 按集数收费。</li></ul>|
##|purchase_unit {必填}|string[]|收费单位。<br><br>当 `recharge_type` 为 `BY_TIERS` 时，枚举值为：<ul><li>`TIER_1`: 1 级。</li><li>`TIER_2`: 2 级。</li><li>`TIER_3`: 3 级。</li><li>`TIER_4`: 4 级。</li><li>`TIER_5`: 5 级。</li></ul>当 `recharge_type` 为 `SUBSCRIPTION`，枚举值为：<ul><li>`WEEKLY`: 按周订阅。</li><li>`MONTHLY`: 按月订阅。</li><li>`QUARTERLY`: 按季度订阅。</li><li>`YEARLY`: 按年订阅。</li></ul>当 `recharge_type` 为 `BY_EPISODES`，需指定一个或多个数字字符串，字符串代表的数字不可大于总集数。|
##|cost {必填}|float[]|级别、订阅周期或集数对应的价格。|
#|product_detail {必填}|string|短剧的其他信息。|
##|company_type|string|短剧的公司类型。<br><br>枚举值：<ul><li>`COPYRIGHT_HOLDER`: 版权方。</li><li>`DISTRIBUTOR`: 发行方。</li></ul>|
##|copyright_holder_name {+条件必填}|string|指定 `company_type` 时必填。<br><br>版权方公司名称。<br><br>长度限制：100 个字符。|
##|app_id{+条件必填}|string|需至少传入 `app_id` 和 `minis_id` 其中之一或同时传入 `app_id` 和 `minis_id`。<br><br>广告中要推广的应用的应用 ID。<br><br>若想获取您的广告账户中的应用 ID 列表，可使用 [/app/list/](1740859313270786.html)。|
##|minis_id{+条件必填}|string|需至少传入 `app_id` 和 `minis_id` 其中之一或同时传入 `app_id` 和 `minis_id`。<br><br>小程序 ID。<br><br>需传入您的小程序在 TikTok 开放平台上的 ID。|
##|total_episodes {必填}|number|短剧的总集数。<br><br>取值范围：1-9,999。|
##|initial_paid_episodes {必填}|number|短剧付费起始集数。例如，若第 11 集起需付费，则该字段需设置为 11。<br><br>取值范围：1-9,999。<br><br>本字段的值需小于 `total_episodes` 的值。|
##|per_episode_duration|number|每集的平均时长，单位为分钟。<br><br>取值范围：0-15。|
##|spoken_language {必填}|string|短剧原声语言。<br><br>枚举值：<ul><li>`ar`: 阿拉伯语。</li><li>`de`: 德语。</li><li>`cs`: 捷克语。</li><li>`en`: 英语。</li><li>`es`: 西班牙语。</li><li>`fr`: 法语。</li><li>`he`: 希伯来语。</li><li>`hi`: 印地语。</li><li>`id`: 印尼语。</li><li>`it`: 意大利语。</li><li>`ja`: 日语。</li><li>`ko`: 韩语。</li><li>`ms`: 马来语。</li><li>`pl`: 波兰语。</li><li>`pt`: 葡萄牙语。</li><li>`ro`: 罗马尼亚语。</li><li>`ru`: 俄语。</li><li>`ta`: 泰米尔语。</li><li>`th`: 泰语。</li><li>`tr`: 土耳其语。</li><li>`vi`: 越南语。</li><li>`zh`: 简体中文。</li><li>`zh-hant`: 繁体中文。</li></ul>|
##|subtitle_language {必填}|string|短剧字幕语言。<br><br>枚举值：<ul><li>`ar`: 阿拉伯语。</li><li>`de`: 德语。</li><li>`cs`: 捷克语。</li><li>`en`: 英语。</li><li>`es`: 西班牙语。</li><li>`fr`: 法语。</li><li>`he`: 希伯来语。</li><li>`hi`: 印地语。</li><li>`id`: 印尼语。</li><li>`it`: 意大利语。</li><li>`ja`: 日语。</li><li>`ko`: 韩语。</li><li>`ms`: 马来语。</li><li>`pl`: 波兰语。</li><li>`pt`: 葡萄牙语。</li><li>`ro`: 罗马尼亚语。</li><li>`ru`: 俄语。</li><li>`ta`: 泰米尔语。</li><li>`th`: 泰语。</li><li>`tr`: 土耳其语。</li><li>`vi`: 越南语。</li><li>`zh`: 简体中文。</li><li>`zh-hant`: 繁体中文。</li></ul>|
##|production_type {必填}|string|制作类型，即短剧是本地短剧还是翻译短剧。<br><br>枚举值：<ul><li>`LOCAL`: 本地短剧。本地演员、本地语言、旁白和字幕。</li><li>`TRANSLATION`: 翻译短剧，为国际发行，附加字幕、旁白和配音。</li></ul>|
##|target_audience {必填}|string|短剧的目标受众。<br><br>枚举值：<ul><li>`MALE`: 男频。目标受众主体为男性，更多地围绕男主人公或从男性视角叙事强调权力财富声望的积累、强大能力的提升、运筹帷幄与设计营谋。</li><li>`FEMALE`: 女频。目标受众主体为女性，更多地围绕女主人公或从女性视角叙事，大多含有浪漫爱情元素。</li><li>`NEUTRAL`: 中立。没有明确目标受众性别。</li></ul>|
##|characters {必填}|string[]|短剧的角色列表。<br><br>最大数量：3。<br><br>枚举值参见 <a href="#item-link-characters 的可选值">`characters` 的可选值</a>。|
##|genres {必填}|string[]|短剧的类别，通常基于主线剧情或情节。<br><br>最大数量：3。<br><br>枚举值参见 <a href="#item-link-genres 的可选值">`genres` 的可选值</a>。|
##|historical_context|string[]|短剧的时代背景或设定。<br><br>最大数量：3。<br><br>枚举值参见 <a href="#item-link-historical_context 的可选值">`historical_context` 的可选值</a>。|
##|actors|string[]|短剧中的演员的名字。<br><br>最大数量：20。<br><br>每个名字的长度限制：100 个字符。|
characters 的可选值
| 值 {30%}| 类型 {15%}| 描述 {55%}|
|---|---|---|
| `ALPHA_MALE` | 霸总 | 商界顶尖、充满权势与财富的男主角，常展现强势、占有欲与极强掌控力。 |
| `ATHLETE` | 运动员 | 受训或参加竞技体育的人物，突出自律、竞争、身体素质等主题。 |
| `BABIES` | 萌宝 | 涉及婴儿、幼儿的出生、抚养或日常生活，经常增添温暖或喜剧情节。 |
| `BADBOY` | 坏男孩 | 叛逆、外表粗犷的男性角色，常被误解，实际上有温柔一面。 |
| `CHEF` | 厨师 | 专注于烹饪技艺的角色，多见于美食或餐厅场景。 |
| `DOCTOR` | 医生 | 医疗专业人士，常卷入高压力、情感浓烈的剧情。 |
| `DRAGON_KING` | 龙王 | 东方奇幻形象，通常是强大的龙神或战神，在短剧情节中常被提及。 |
| `ELITE_PROFESSION` | 职场精英 | 如警察、律师、运动员、医生、飞行员或军人等专业范的角色。 |
| `EMPEROR` | 皇帝 | 帝国最高统治者，权威与政治力量象征。 |
| `EXTRAORDINARY_TALENT` | 超能力/异能人士 | 拥有如意念操控、读心等超常能力的角色。 |
| `GANG_MAFIA` | 黑帮/黑手党 | 参与有组织犯罪，冷酷、忠诚与复杂利益交织。 |
| `HEIRESS` | 千金 | 出生豪门的女生，面对身份压力与期待。 |
| `HEROINE` | 大女主 | 独立、坚韧、上进并有主导力的女性主角。 |
| `HIDDEN_IDENTITY` | 马甲 | 用假身份或化名隐藏真相，引发悬疑或冲突。 |
| `HOUSE_WIFE` | 家庭主妇 | 以家庭和家务管理为主的女性角色。 |
| `IDOL` | 偶像明星 | 以明星、演艺等身份在公众中拥有高人气的角色。 |
| `KUNG_FU_MASTER` | 武林高手 | 修习传统功夫的高手，象征自律与荣誉。 |
| `LIVE_IN_SON_IN_LAW` | 赘婿 | 入赘、居住在妻子家庭的男性，常面临压力和挑战。 |
| `MODERN_MOMS` | 宝妈 | 以育儿、家庭为主导的女性角色。 |
| `NOBODY` | 小人物 | 无特殊身份的普通人，常衬托精英角色。 |
| `PRINCESS_CONSORT` | 王妃 | 嫁入皇室、多涉宫斗权谋的女性贵族。 |
| `PSYCHO_SWEETHEART` | 病娇 | 表面可爱却对感情痴迷，甚至有危险倾向。 |
| `QUEEN` | 皇后 | 皇帝女性伴侣，兼具优雅与权利，偶有权谋。 |
| `SPIRIT_CULTIVATOR` | 修仙者 | 修炼得到长生或超自然力量的奇幻角色。 |
| `SUBSTITUTE` | 替身 | 冒充或代替他人的角色，引发身份错乱和戏剧冲突。 |
| `TEENS` | 校园青少年 | 校园、青春、友情、初恋等成长经历。 |
| `VAMPIRE` | 吸血鬼 | 以吸食血液为生，具备不死与超自然能力的生物。 |
| `WARLORD` | 战神 | 象征极致战力与领导力的神话英雄形象。 |
| `WEREWOLF` | 狼人 | 能在满月变为狼的传说生物，狼群通常有“狼王”。 |
| `OTHERS` | 其他 | 未被列举，可根据剧情定制的其它角色类型。 |
genres 的可选值
| 值 {30%}| 类型 {15%}| 描述 {55%}|
|---|---|---|
| `ACTION` | 动作 | 以打斗、快节奏场面、特技为主。 |
| `AFFAIR` | 婚外情 | 涉及婚外恋、隐秘与冲突。 |
| `AGE_GAP_ROMANCE` | 忘年恋 | 恋人之间年龄差距大的爱情故事。 |
| `BITTER_LOVE` | 虐恋 | 充满误解、痛苦和心碎的爱情故事。 |
| `BUILD_FROM_SCRATCH` | 白手起家 | 主角通过努力打拼实现财富积累。 |
| `CHILDHOOD_SWEETHEARTS` | 青梅竹马 | 从小一起长大，渐生情愫的爱情故事。 |
| `CHINESE_FANTASY` | 仙侠 | 含中国古风、仙人、神魔、法术等幻想元素。 |
| `COME_UPPANCE_RETRIBUTION` | 打脸虐渣 | 主角揭穿、打败反派或渣男，获得复仇快感。 |
| `COMEBACK` | 强者回归 | 主角历经苦难后东山再起，复仇或正名。 |
| `COMEDY` | 喜剧 | 轻松、幽默、娱乐性质的故事。 |
| `CONSPIRACY` | 设计陷害 | 包含算计、陷害及复杂权谋的剧情。 |
| `CONTRACT_LOVE` | 协议爱情/婚姻 | 基于协议、合约的关系，后发展出真爱或情感纠葛。 |
| `COUGAR_CUB_DYNAMIC` | 姐弟恋 | 女方年龄比男方大的恋爱关系。 |
| `CRIME` | 犯罪 | 围绕犯罪、调查、正义展开的故事。 |
| `DISASTER` | 灾难 | 自然或人为灾祸对人物命运的影响。 |
| `DISGUISE` | 隐藏身份 | 角色为目的隐瞒身份、达成目标的情节。 |
| `DRAGON_TIGER_PACT` | 强强联合 | 强者联合共斗、合力达成目标。 |
| `DRAMA` | 剧情 | 聚焦人物成长、关系冲突的情感故事。 |
| `ENEMIES_TO_LOVERS` | 敌人到恋人/欢喜冤家 | 先敌对后相爱的浪漫剧情。 |
| `FAMILY_BOUNDS` | 家庭关系 | 以家庭关系、冲突与情感纽带为主线。 |
| `FAMILY_ETHICS` | 伦理 | 探讨道德冲突、社会禁忌或复杂伦理。 |
| `FANTASY_ROMANCE` | 玄幻/奇幻爱情 | 充满奇幻设定和超自然元素的爱情故事。 |
| `FEMALE_GROWTH` | 女性成长 | 女性主角自我成长、觉醒和自强的故事。 |
| `FIGHT_BULLYING` | 霸凌反击 | 围绕角色反抗校园或社会恶意，成长及正义之旅。 |
| `FLASH_MARRIED` | 闪婚 | 冲动快速结婚，后产生真实情感的故事。 |
| `GANG_FIGHTS` | 帮派斗争 | 帮派之间的争斗、恩怨情仇。 |
| `HARD_WIN_LOVE` | 追妻 | 一方努力追求或夺回心爱之人的剧情。 |
| `HORRORS_AND_THRILLERS` | 恐怖惊悚 | 以悬念、恐怖要素制造紧张氛围。 |
| `INDULGENT_LOVE` | 浪漫甜宠 | 轻松治愈，甜蜜互动、约会、惊喜、求婚等情节。 |
| `INVINCIBLE` | 天下无敌 | 主角实力超群，难以被打败的故事。 |
| `LIFE_TRANSFORMATION` | 逆袭 | 草根晋级上层，实现财富地位逆转的故事。 |
| `LOVE_AFTER_MARRIAGE` | 先婚后爱 | 先结婚后逐渐相爱的故事。 |
| `LOVE_AT_FIRST_SIGHT` | 一见钟情 | 初见即一见倾心，发展为爱情的剧情。 |
| `LOVE_IN_WEALTHY_FAMILIES` | 豪门爱情 | 以豪门家族为背景，面对家族压力与权力博弈。 |
| `LOVE_ON_CAMPUS` | 校园爱情 | 以校园、大学为场景的青春恋情故事。 |
| `LOVE_TRIANGLE` | 多角恋 | 三人或多人之间复杂的情感纠葛。 |
| `ONE_NIGHT_STAND` | 一夜情 | 短暂、偶发的恋爱或性关系为主线的故事。 |
| `PALACE_FIGHT` | 宫斗 | 古代宫廷权谋、女性间争宠和情感角力。 |
| `POWER_CALCULUS` | 权谋 | 以算计、权力争斗为核心的剧情。 |
| `PREGNANCY_ESCAPE` | 带球跑 | 女主怀孕后离开，涉及责任与复合的情节。 |
| `RECONCILIATION_AFTER_BREAKUP` | 破镜重圆 | 分手/离婚后重新和好的情感剧情。 |
| `REDEMPTION` | 救赎 | 角色寻求宽恕、自我救赎或洗心革面的剧情。 |
| `RETURN_FOR_REVENGE` | 复仇回归 | 主角遭遇背叛或伤害后卷土重来，完成复仇。 |
| `REVERSE_HAREM` | 逆后宫 | 女主被多个男性追求、环绕的剧情。 |
| `SECRET_CRUSH_COME_TRUE` | 暗恋成真 | 长期暗恋最终开花结果的故事。 |
| `SPY` | 谍战 | 以特工、潜伏、情报行动为主线，涉及暴力与审讯。 |
| `SUSPENSE` | 悬疑 | 充满悬念和逆转，令观众期待和紧张的剧情。 |
| `SWAPPED_HEIRESSES` | 真假千金 | 涉及财产继承、身份错乱的剧情。 |
| `TABOO_RELATIONSHIP` | 禁忌关系 | 越过道德/社会边界的爱情，如师生、近亲、异种等。 |
| `TEAR_JERKERS` | 催泪 | 煽情感人，容易引发观众共鸣与泪水。 |
| `WORKPLACE_ROMANCE` | 职场恋情 | 以上班、工作环境为背景的爱情故事。 |
historical_context 的可选值
| 值 {30%}| 类型 {15%}| 描述 {55%}|
|---|---|---|
| `ANCIENT_SETTING` | 古代 | 故事发生在东方或西方的古代背景。 |
| `BOOK_TRANSMIGRATION` | 穿书 | 剧情涉及角色穿越进书本世界。 |
| `FICTIONAL` | 架空 | 发生在虚构时空背景下的故事。 |
| `MODERN` | 现代 | 设定在现代社会的剧情。 |
| `PERIOD_IN_60_80S` | 年代剧 | 故事设定在 20 世纪 60 至 80 年代。 |
| `REPUBLIC_OF_CHINA` | 民国 | 故事发生在中国民国时期。 |
| `SECOND_CHANCE` | 重生 | 以重生、获得新生、用前世记忆逆袭为主要内容。 |
| `TIME_SPACE_TRAVEL` | 穿越 | 剧情涉及人物跨越时空经历新生活的故事。 |
示例
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/catalog/product/upload/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"bc_id": "{{bc_id}}",
"catalog_id": "{{catalog_id}}",
"products": [
{
"sku_id": "{{sku_id}}",
"title": "{{title}}",
"description": "{{description}}",
"availability": "IN_STOCK",
"image_url": "{{image_url}}",
"brand": "{{brand}}",
"additional_image_urls": ["{{additional_image_url}}", "{{additional_image_url}}"],
"item_group_id": "{{item_group_id}}",
"google_product_category": "{{google_product_category}}",
"global_trade_item_number": "{{global_trade_item_number}}",
"manufacturer_part_number": "{{manufacturer_part_number}}",
"product_detail": {
"condition": "NEW",
"age_group": "ADULT",
"color": "{{color}}",
"gender": "UNISEX",
"material": "{{material}}",
"pattern": "{{pattern}}",
"product_category": "{{product_category}}",
"shipping": "US:CA:Ground:9.99 USD",
"size": "{{size}}",
"tax": "{{tax}}"
},
"price_info": {
"price": {{price}},
"currency":"USD",
"sale_price": {{sale_price}},
"sale_price_effective_date": "2023-12-11T23:59+00:00/2023-12-15T23:59+00:00"
},
"landing_page": {
"landing_page_url": "{{landing_page_url}}"
},
"extra_info": {
"custom_label_0": "{{custom_label_0}}",
"custom_label_1": "{{custom_label_1}}",
"custom_label_2": "{{custom_label_2}}",
"custom_label_3": "{{custom_label_3}}",
"custom_label_4": "{{custom_label_4}}"
}
}
]
}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|message |string|返回信息。更多信息参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|request_id|string| 请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|feed_log_id| string|商品处理日志 ID。|
示例
(code curl http)
{
"message": "OK",
"code": 0,
"data": {
"feed_log_id": "{{feed_log_id}}"
},
"request_id": "{{request_id}}"
}
(/code)