创建商品库

您可以使用本接口通过主要信息（例如名称，定向位置和货币单位）创建并设置您的商品库。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/catalog/create/| /v1.3/catalog/create/| |请求参数名称 |country|region_code| |请求参数类型|bc_id: number|bc_id: string| |新增请求参数||additional_config_list`|

## 请求

**地址** https://business-api.tiktok.com/open_api/v1.3/catalog/create/


**方法** POST

**Header**

```xtable
|字段|类型|描述|
|--- |--- |--- |
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|

参数

|字段|类型|描述|
|--- |--- |--- |
|bc_id {必填}|string|商务中心ID。|
|name {必填}|string|商品库名称。<br><br>长度限制：128 字符。|
|catalog_type {必填}|string|商品库类型。<br>枚举值： <ul><li>`ECOM`：电商商品库。</li><li> `HOTEL`：酒店商品库。</li><li>`FLIGHT`：航班商品库。</li><li>`DESTINATION`：目的地商品库。</li><li>`ENTERTAINMENT`：娱乐商品库。</li><li>`AUTO_VEHICLE`：汽车库存商品库。</li><li>`AUTO_MODEL`： 汽车型号商品库。</li><li>`MINI_SERIES`：短剧商品库。</li></ul><p><span style="color:darkred"><b>注意</b></span>：<ul><li>娱乐商品库目前在 Alpha 测试阶段，是仅向受邀开发者开放的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表，但无法保证申请就能入选。</li><li>短剧商品库目前在测试阶段，是仅向受邀开发者开放的白名单功能。如需使用此功能，请联系您的 TikTok 销售代表，但无法保证申请就能入选。</li></ul>|
|catalog_conf {必填}|object|商品库配置信息。|
#|region_code {必填}|string|主要定向地域的二字地区代码。<br><br>若想获取可定向的地域，可使用[/catalog/available_country/get/](1740491257516034.html)并从返回的`region_codes`中挑选地区代码。<br><br>当 `catalog_type` 为 `AUTO_VEHICLE` 或 `AUTO_MODEL` 时，参见<a href="#item-link-汽车库存和型号商品库的地域代码和币种列表">汽车库存和型号商品库的地域代码和币种列表</a>查找支持的 `region_code` 值。<br><br>若想了解某个地区代码对应的地区，请查看[附录-地区代码](1737585867307010.html)。<br><br>示例: `US`。<br><br><p><span style="color:darkred"><b>注意</b></span>：本字段设置后不支持更新。|
#|currency {必填}|string|主要定向地域的币种。<br><br>如需了解支持的币种，请查看[不同币种的预算校验比例及精度](https://business-api.tiktok.com/portal/docs?id=1737585839634433#item-link-%E4%B8%8D%E5%90%8C%E5%B8%81%E7%A7%8D%E7%9A%84%E9%A2%84%E7%AE%97%E6%A0%A1%E9%AA%8C%E6%AF%94%E4%BE%8B%E5%8F%8A%E7%B2%BE%E5%BA%A6)中的<b>编码</b>列。<br><br>当 `catalog_type` 为 `AUTO_VEHICLE` 或 `AUTO_MODEL` 时，参见<a href="#item-link-汽车库存和型号商品库的地域代码和币种列表">汽车库存和型号商品库的地域代码和币种列表</a>查找指定的 `region_code` 对应的 `currency` 值。<br><br>示例: `USD`。<br><br><p><span style="color:darkred"><b>注意</b></span>：本字段设置后不支持更新。|
#|channel |string| 创建商品库的渠道。<br><br>枚举值:<ul><li>`PARTNER`：第三方合作伙伴。</li><li>`CLIENT`：直客广告主。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：本字段设置后不支持更新。|
#|additional_config_list|object[]|仅当 `catalog_type` 为 `MINI_SERIES` 时生效。<br><br>额外定向地域的详细信息。<br><br>无最大数量限制。<br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>本字段设置后不支持更新。</li><li>如需通过短剧商品库定向多个地域，需在创建商品库时通过 `additional_config_list` 指定其他定向地域。随后上传定向多个地域的短剧。</li></ul>|
##|region_code {+条件必填}|string|传入 `additional_config_list` 时本字段必填。<br><br>额外定向地域的地区代码。<br><br>若想获取可定向的地域，可使用[/catalog/available_country/get/](1740491257516034.html)并从返回的`region_codes`中挑选地区代码。<br><br>若想了解某个地区代码对应的地区，请查看[附录-地区代码](1737585867307010.html)。<br><br>示例: `GB`。<br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>本字段设置后不支持更新。</li><li>不支持重复的地区代码。</li></ul>|
##|currency {+条件必填}|string|额外定向地域的币种。<br><br>如需了解支持的币种，请查看[不同币种的预算校验比例及精度](https://business-api.tiktok.com/portal/docs?id=1737585839634433#item-link-%E4%B8%8D%E5%90%8C%E5%B8%81%E7%A7%8D%E7%9A%84%E9%A2%84%E7%AE%97%E6%A0%A1%E9%AA%8C%E6%AF%94%E4%BE%8B%E5%8F%8A%E7%B2%BE%E5%BA%A6)中的<b>编码</b>列。<br><br>示例: `GBP`。<br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>本字段设置后不支持更新。</li><li>每个额外定向地域只能指定一个币种。</li></ul>|

汽车库存和型号商品库的地域代码和币种列表

下表列出了汽车库存和型号商品库中支持的region_code值和对应的currency 值。

|地域{20%}|<code>region_code</code>值{20%}|<code>currency</code>值{60%}|
|---|---|---|
|阿根廷|`AR`|`ARS`|
|澳大利亚|`AU`|`AUD`|
|奥地利|`AT`|`EUR`|
|阿塞拜疆|`AZ`|`AZN`|
|巴林|`BH`|`BHD`|
|孟加拉国|`BD`|`BDT`|
|白俄罗斯|`BY`|`BYN`|
|比利时|`BE`|`EUR`|
|巴西|`BR`|`BRL`|
|柬埔寨|`KH`|`KHR`|
|加拿大|`CA`|`CAD`|
|智利|`CL`|`CLP`|
|哥伦比亚|`CO`|`COP`|
|捷克|`CZ`|`CZK`|
|丹麦|`DK`|`DKK`|
|厄瓜多尔|`EC`|`USD`|
|埃及|`EG`|`EGP`|
|芬兰|`FI`|`EUR`|
|法国|`FR`|`EUR`|
|德国|`DE`|`EUR`|
|希腊|`GR`|`EUR`|
|匈牙利|`HU`|`HUF`|
|印度尼西亚|`ID`|`IDR`|
|伊拉克|`IQ`|`IQD`|
|爱尔兰|`IE`|`EUR`|
|以色列|`IL`|`ILS`|
|意大利|`IT`|`EUR`|
|日本|`JP`|`JPY`|
|哈萨克斯坦|`KZ`|`KZT`|
|韩国|`KR`|`KRW`|
|科威特|`KW`|`KWD`|
|马来西亚|`MY`|`MYR`|
|墨西哥|`MX`|`MXN`|
|摩洛哥|`MA`|`MAD`|
|荷兰|`NL`|`EUR`|
|新西兰|`NZ`|`NZD`|
|挪威|`NO`|`NOK`|
|阿曼|`OM`|`OMR`|
|巴基斯坦|`PK`|`PKR`|
|秘鲁|`PE`|`PEN`|
|菲律宾|`PH`|`PHP`|
|波兰|`PL`|`PLN`|
|葡萄牙|`PT`|`EUR`|
|卡塔尔|`QA`|`QAR`|
|罗马尼亚|`RO`|`RON`|
|俄罗斯|`RU`|`RUB`|
|沙特阿拉伯|`SA`|`SAR`|
|塞尔维亚|`RS`|`RSD`|
|新加坡|`SG`|`SGD`|
|南非|`ZA`|`ZAR`|
|西班牙|`ES`|`EUR`|
|瑞典|`SE`|`SEK`|
|瑞士|`CH`|`CHF`|
|中国台湾|`TW`|`TWD`|
|泰国|`TH`|`THB`|
|土耳其|`TR`|`TRY`|
|乌克兰|`UA`|`UAH`|
|阿拉伯联合酋长国|`AE`|`AED`|
|英国|`GB`|`GBP`|
|美国|`US`|`USD`|
|乌拉圭|`UY`|`UYU`|
|越南|`VN`|`VND`|

示例

(code curl http)
    curl -X POST -H "Access-Token:YOUR_ACCESS_TOKEN" \
    -H "Content-Type:application/json" \
    -d '{\"bc_id\": BC_ID,\"name\": \"NAME\",\"catalog_type\": \"CATALOG_TYPE\",\"catalog_conf\": {\"region_code\": \"COUNTRY\",\"currency\": \"CURRENCY\"}}' \
    https://business-api.tiktok.com/open_api/v1.3/catalog/create/
(/code)

返回

|字段|类型|描述|
|--- |--- |--- |
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data|object|返回数据。|
#|catalog_id|string|商品库ID。|
|request_id |string|请求的日志 ID，唯一标识一个请求。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
    "catalog_id": "6869649744440854277"
},
"request_id": "2020090707561801023125321410627"
}
(/code);