--- title: "更新尺码" description: "更新尺码表，商品将优先使用最新更新的尺码数据进行展示。" doc_type: openapi doc_category: openapi doc_version: v20270301 source_url: html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-rest-api/app-open-api/size-chart/update-a-size-chart' md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-rest-api/app-open-api/size-chart/update-a-size-chart.md' --- # 更新尺码 更新尺码表，商品将优先使用最新更新的尺码数据进行展示。 - **Base URL:** `https://{handle}.myshopline.com/admin/openapi` - **Required Scopes:** `write_product_sizechart` - **API Version:** v20270301 - **API Type:** Admin - **API Protocol:** RESTful ## Endpoint ```http PUT /sizechart.json ``` ## Base URL * `https://{handle}.myshopline.com/admin/openapi` * `{handle}`: `handle` ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 `open001.myshopline.com` 的店铺，其 `handle` 是 `open001` 。 ## Required Permissions * `write_product_sizechart` ## Request ### Request Headers * `Content-Type` string (required) 字段值固定为 `application/json; charset=utf-8`。 * `Authorization` string (required) 资源的访问令牌。参考 [应用授权](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/app-authorization.md?lang=zh-hans-cn) 获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。 ### Request Body * `req` object 请求参数。 * `collection_list` array 当 `applicable_product_type` 传入 `COLLECTION` 时，使用此字段传入尺码表匹配的商品分类 ID 列表。 最大个数限制：50 * `languages` array 当 `language_scope` 传入 `SPECIFIC` 时，使用此字段以数组的形式传入尺码表匹配的语言代码。支持的语言枚举如下： - `pt-pt`: 葡萄牙语（葡萄牙） - `tr`: 土耳其语 - `zh-hans-cn`: 简体中文 - `vi`: 越南语 - `sv`: 瑞典语 - `zh-hant-tw`: 繁体中文 - `th`: 泰语 - `ar`: 阿拉伯语 - `pl`: 波兰语 - `ro`: 罗马尼亚语 - `sk`: 斯洛伐克语 - `ko`: 韩语 - `lv`: 拉脱维亚语 - `ms`: 马来语 - `pt`: 葡萄牙语（巴西） - `it`: 意大利语 - `ja`: 日语 - `lt`: 立陶宛语 - `sl`: 斯洛文尼亚语 - `nb`: 挪威语（博克马尔语） - `ru`: 俄语 - `nl`: 荷兰语 - `en`: 英语 - `id`: 印度尼西亚语 - `et`: 爱沙尼亚语 - `bg`: 保加利亚语 - `hi`: 印地语 - `cs`: 捷克语 - `es`: 西班牙语 - `fr`: 法语 - `fi`: 芬兰语 - `da`: 丹麦语 - `el`: 希腊语 - `de`: 德语 - `hr`: 克罗地亚语 - `hu`: 匈牙利语 * `title` string 尺码表标题，超过最大长度限制会被截断。 最大长度限制：100 * `contents` array 尺码数据列表，按顺序从第一个尺码数据开始取，取到最大数量后将会截断剩余数据。 最大数量限制：10 * `table_content` object 表格类型的数据体，常用于以表格形式显示尺码数据。例如 S 的肩宽是60，腰围是55。 * `country_size` object 国家尺码数据，代表此表格内的尺码在不同国家下的名称。 * `remark` string 表格备注。 最大长度限制：255 * `size_data` array 表格数据体，一个数组代表表格的一行数据，第一个数组为表头，数组中的每个元素对应表格中的单元格数据。 最大行数限制：50 * `unit` object 表格的尺码数据使用的单位。 * `tabs` array tab 类型的数据体，可添加多个 tab 分栏并在分栏内添加各类型的尺码数据内容。 最大分栏数量限制：5 * `tab_content` array 包含各种尺码内容数据的 tab 分栏数据体。 最大个数限制：10 * `tab_name` string tab 分栏的名称。 最大长度限制：50 * `text` string 文本类型内容。 * `title` string 尺码表标题，超过长度限制会被截断。 最大长度限制：50 * `type` string 尺码表中支持的内容类型枚举，枚举值如下所示： - `SIZE_CHART`：表格类型 - `CROSS_SIZE_CHART`：交叉表格类型 - `IMAGE`：图片类型 - `TEXT`：文本类型 - `TAB`：Tab 类型 * `url` string 图片类型内容，当 `type` 传入 `IMAGE` 时，传入图片的 URL 地址。 * `cross_table_content` object 交叉表格类型的数据体，常用于显示不同身体参数适合的具体尺码。例如身高170cm，体重70kg适用L。 * `row_unit` object 交叉表格中行的尺码单位。 * `size_data` array 交叉表格数据体，第一个元素为表头，数组中的每个元素对应表格中的一行数据。 最大个数限制：50 * `column_title` string 交叉表格中列的标题，用于说明列的数据代表的尺码信息。例如 `weight` 表示列的数据为体重数据。默认为 `weight`。 最大长度限制：20 * `column_unit` object 交叉表格中列的尺码单位。 * `remark` string 交叉表格的备注。 最大长度限制：255 * `row_title` string 交叉表格中行的标题，用于说明行的数据代表的尺码信息。例如 `height` 表示行的数据为身高数据。 默认为 `height`。 最大长度限制：20 * `status` boolean 尺码表的发布状态。 - `true`: 表示发布尺码表 - `false`: 表示不发布尺码表 默认值为：`false` * `applicable_attribute_list` array 是一个尺码表适用商品属性的列表，每个属性可以用来描述商品的特征，如 `size` 等。 单个变体属性名称长度限制：255 最大个数限制：50 * `language_scope` string 将尺码表与语言进行匹配的方法类型，当`language_scope`=`SPECIFIC` 时，`languages` 不能为空，需通过 `languages` 指定支持的语言。枚举值类型如下： - `ALL`: 全部语言 - `SPECIFIC`: 指定语言 默认为: `ALL` * `product_list` array 当 `applicable_product_type` 传入 `SPECIFIC` 时，使用此字段传入尺码表匹配的商品 ID 列表。 最大数量限制：100 * `size_chart_id` string 尺码表的唯一 ID。 * `applicable_product_type` string 将尺码表与商品进行匹配的方法类型。 - `ALL`：适用所有商品 - `SPECIFIC`：适用于指定商品 - `COLLECTION`：适用于指定商品分类 默认值：`ALL` ## Response ### Status Codes * `200` 更多状态码信息，参考 [HTTP 状态码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/http-status-code.md?lang=zh-hans-cn)。 * `401` * `429` ### Response Headers * `traceId` 请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。 ### Response Body #### 200 * `data` object 响应数据。 * `size_chart_id` string 尺码表 ID。 #### 401 * `errors` string 错误描述。 #### 429 * `errors` string 错误描述。 ## OpenAPI Definition ```json { "description": "更新尺码表，商品将优先使用最新更新的尺码数据进行展示。", "externalDocs": { "description": "接口使用的权限点: `write_product_sizechart` ，更多权限点使用信息，请参考:", "url": "ec20/3cv5d7wpfgr6a8z5/xabczf5442284vkq?lang=zh-hans-cn", "errorTableDescription": "" }, "operationId": "8UTyyjYO", "parameters": [ { "name": "Content-Type", "in": "header", "description": "字段值固定为 `application/json; charset=utf-8`。", "required": true, "style": "string", "schema": { "name": "Content-Type", "type": "string", "example": "application/json; charset=utf-8" } }, { "name": "Authorization", "in": "header", "description": "资源的访问令牌。参考 [应用授权](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/app-authorization.md?lang=zh-hans-cn) 获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。", "required": true, "style": "string", "schema": { "name": "Authorization", "description": "资源的访问令牌。请参考 [应用授权](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/app-authorization.md?lang=zh-hans-cn) 获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入", "type": "string", "example": "Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA" }, "example": "Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA" } ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "req": { "name": "req", "description": "请求参数。", "type": "object", "properties": { "collection_list": { "name": "collection_list", "description": "当 `applicable_product_type` 传入 `COLLECTION` 时，使用此字段传入尺码表匹配的商品分类 ID 列表。\n\n最大个数限制：50", "type": "array", "items": { "name": "collection_list", "description": "当 `applicable_product_type` 传入 `COLLECTION` 时，使用此字段传入尺码表匹配的商品分类 ID 列表。\n\n最大个数限制：50", "type": "string", "example": "12260895952237462871473144" }, "example": [ "12260895952237462871473144" ] }, "languages": { "name": "languages", "description": "当 `language_scope` 传入 `SPECIFIC` 时，使用此字段以数组的形式传入尺码表匹配的语言代码。支持的语言枚举如下：\n\n- `pt-pt`: 葡萄牙语（葡萄牙）\n- `tr`: 土耳其语\n- `zh-hans-cn`: 简体中文\n- `vi`: 越南语\n- `sv`: 瑞典语\n- `zh-hant-tw`: 繁体中文\n- `th`: 泰语\n- `ar`: 阿拉伯语\n- `pl`: 波兰语\n- `ro`: 罗马尼亚语\n- `sk`: 斯洛伐克语\n- `ko`: 韩语\n- `lv`: 拉脱维亚语\n- `ms`: 马来语\n- `pt`: 葡萄牙语（巴西）\n- `it`: 意大利语\n- `ja`: 日语\n- `lt`: 立陶宛语\n- `sl`: 斯洛文尼亚语\n- `nb`: 挪威语（博克马尔语）\n- `ru`: 俄语\n- `nl`: 荷兰语\n- `en`: 英语\n- `id`: 印度尼西亚语\n- `et`: 爱沙尼亚语\n- `bg`: 保加利亚语\n- `hi`: 印地语\n- `cs`: 捷克语\n- `es`: 西班牙语\n- `fr`: 法语\n- `fi`: 芬兰语\n- `da`: 丹麦语\n- `el`: 希腊语\n- `de`: 德语\n- `hr`: 克罗地亚语\n- `hu`: 匈牙利语", "type": "array", "items": { "name": "languages", "description": "当 `language_scope` 传入 `SPECIFIC` 时，使用此字段以数组的形式传入尺码表匹配的语言代码。支持的语言枚举如下：\n\n- `pt-pt`: 葡萄牙语（葡萄牙）\n- `tr`: 土耳其语\n- `zh-hans-cn`: 简体中文\n- `vi`: 越南语\n- `sv`: 瑞典语\n- `zh-hant-tw`: 繁体中文\n- `th`: 泰语\n- `ar`: 阿拉伯语\n- `pl`: 波兰语\n- `ro`: 罗马尼亚语\n- `sk`: 斯洛伐克语\n- `ko`: 韩语\n- `lv`: 拉脱维亚语\n- `ms`: 马来语\n- `pt`: 葡萄牙语（巴西）\n- `it`: 意大利语\n- `ja`: 日语\n- `lt`: 立陶宛语\n- `sl`: 斯洛文尼亚语\n- `nb`: 挪威语（博克马尔语）\n- `ru`: 俄语\n- `nl`: 荷兰语\n- `en`: 英语\n- `id`: 印度尼西亚语\n- `et`: 爱沙尼亚语\n- `bg`: 保加利亚语\n- `hi`: 印地语\n- `cs`: 捷克语\n- `es`: 西班牙语\n- `fr`: 法语\n- `fi`: 芬兰语\n- `da`: 丹麦语\n- `el`: 希腊语\n- `de`: 德语\n- `hr`: 克罗地亚语\n- `hu`: 匈牙利语", "type": "string", "example": "EN,CN" }, "example": [ "EN,CN" ] }, "title": { "name": "title", "description": "尺码表标题，超过最大长度限制会被截断。\n\n最大长度限制：100", "type": "string", "example": "My SizeChart" }, "contents": { "name": "contents", "description": "尺码数据列表，按顺序从第一个尺码数据开始取，取到最大数量后将会截断剩余数据。\n\n最大数量限制：10", "type": "array", "items": { "name": "contents", "description": "尺码数据列表，按顺序从第一个尺码数据开始取，取到最大数量后将会截断剩余数据。\n\n最大数量限制：10", "type": "object", "properties": { "table_content": { "name": "table_content", "description": "表格类型的数据体，常用于以表格形式显示尺码数据。例如 S 的肩宽是60，腰围是55。", "type": "object", "properties": { "country_size": { "name": "country_size", "description": "国家尺码数据，代表此表格内的尺码在不同国家下的名称。", "type": "object", "properties": { "country_size_data": { "name": "country_size_data", "description": "国家尺码数据, 数组的第一个元素代表国家，其他元素代表不同尺码在这个国家的名称。", "type": "array", "items": { "name": "country_size_data", "description": "国家尺码数据, 数组的第一个元素代表国家，其他元素代表不同尺码在这个国家的名称。", "type": "object", "properties": { "country": { "name": "country", "description": "国家名称。\n\n最大长度限制：19", "type": "string", "example": "United States" }, "data": { "name": "data", "description": "表格中不同尺码在当前国家的名称数组。\n\n最大个数限制：21\n\n数组中每个元素最大长度限制：19", "type": "array", "items": { "name": "data", "description": "表格中不同尺码在当前国家的名称数组。\n\n最大个数限制：21\n\n数组中每个元素最大长度限制：19", "type": "string", "example": "78,89" }, "example": [ "78,89" ] } }, "required": [ "country", "data" ], "example": { "country": "United States", "data": [ "78,89" ] } }, "example": [ { "data": [ "78,89" ], "country": "United States" } ] }, "cover_attribute": { "name": "cover_attribute", "description": "是否覆盖尺码规格文案，传入 `true` 时将使用国家尺码名称替代页面上的尺码属性值进行展示。\n\n● `true`：表示覆盖\n \n● `false`：表示不覆盖\n \n默认取值为 `false`\n\n", "type": "boolean", "example": false }, "status": { "name": "status", "description": "是否开启国家尺码功能开关。\n\n● `true`：表示开启功能\n \n● `false`：表示不开启功能\n\n默认取值为`false`\n\n", "type": "boolean", "example": true } }, "required": [ "country_size_data" ], "example": { "country_size_data": [ { "country": "United States", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true } }, "remark": { "name": "remark", "description": "表格备注。\n\n最大长度限制：255", "type": "string", "example": "1inch=2.54cm" }, "size_data": { "name": "size_data", "description": "表格数据体，一个数组代表表格的一行数据，第一个数组为表头，数组中的每个元素对应表格中的单元格数据。\n\n最大行数限制：50", "type": "array", "items": { "name": "size_data", "description": "表格数据体，一个数组代表表格的一行数据，第一个数组为表头，数组中的每个元素对应表格中的单元格数据。\n\n最大行数限制：50", "type": "object", "properties": { "row_data": { "name": "row_data", "description": "数组形式的表格行数据，数组中每个元素代表一个单元格。\n\n每个数组最大元素数量：50\n\n每个元素最大长度限制为：19 ", "type": "array", "items": { "name": "row_data", "description": "数组形式的表格行数据，数组中每个元素代表一个单元格。\n\n每个数组最大元素数量：50\n\n每个元素最大长度限制为：19 ", "type": "string", "example": "XS,64" }, "example": [ "XS,64" ] } }, "required": [ "row_data" ], "example": { "row_data": [ "XS,64" ] } }, "example": [ { "row_data": [ "XS,64" ] } ] }, "unit": { "name": "unit", "description": "表格的尺码数据使用的单位。", "type": "object", "properties": { "convert_unit": { "name": "convert_unit", "description": "尺码数据的可选展示单位。客户可以在默认单位（`default_unit`）和此单位之间切换展示尺码。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。默认为 `in`。", "type": "string", "example": "in" }, "default_unit": { "name": "default_unit", "description": "尺码数据的默认展示单位。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。 ，默认为 `cm`。", "type": "string", "example": "cm" }, "unit_type": { "name": "unit_type", "description": "表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有：\n- `LENGTH` :长度类型单位\n- `WEIGHT`（默认）：重量类型单位\n- `BULK`：体积类型单位\n\n每一种类型下支持的单位枚举如下：\n\n| 单位类型 | 单位类型描述 | 支持单位 | 支持单位描述 | \n| :--: | :--: | :--: | :--: | \n| LENGTH | 长度| feet |英尺 | \n| LENGTH | 长度| m |米 | \n| LENGTH | 长度| cm |厘米 | \n| LENGTH | 长度| mm |毫米 | \n| LENGTH | 长度| in |英寸 | \n| WEIGHT | 重量(默认)| lb | 磅 | \n| WEIGHT | 重量(默认)| oz | 盎司 | \n| WEIGHT | 重量(默认)| kg | 千克 | \n| WEIGHT | 重量(默认)| g | 克 | \n| WEIGHT | 重量(默认)| mg | 毫克 | \n| BULK | 体积 | us_gal | 加仑 (美) | \n| BULK | 体积 | uk_gal | 加仑 (英) | \n| BULK | 体积 | oz_us | 液体盎司 (美)| \n| BULK | 体积 | oz_uk | 液体盎司(英) | \n| BULK | 体积 | ml | 毫升 |\n| BULK | 体积 | l | 升 |", "type": "string", "example": "LENGTH" } }, "example": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "in" } } }, "required": [ "size_data" ], "example": { "unit": { "unit_type": "LENGTH", "convert_unit": "in", "default_unit": "cm" }, "country_size": { "country_size_data": [ { "data": [ "78,89" ], "country": "United States" } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ] } }, "tabs": { "name": "tabs", "description": "tab 类型的数据体，可添加多个 tab 分栏并在分栏内添加各类型的尺码数据内容。\n \n最大分栏数量限制：5", "type": "array", "items": { "name": "tabs", "description": "tab 类型的数据体，可添加多个 tab 分栏并在分栏内添加各类型的尺码数据内容。\n \n最大分栏数量限制：5", "type": "object", "properties": { "tab_content": { "name": "tab_content", "description": "包含各种尺码内容数据的 tab 分栏数据体。\n\n最大个数限制：10", "type": "array", "items": { "name": "tab_content", "description": "包含各种尺码内容数据的 tab 分栏数据体。\n\n最大个数限制：10", "type": "object", "properties": { "tabs": { "name": "tabs", "description": "二级 tab 数据体，tab 可以嵌套在 tab 下形成二级 tab 的效果，最多嵌套2级，可添加多个 tab 分栏并在分栏内添加除 tab 外的其他类型的尺码数据内容。 \n\n最大tab分栏数量限制：5", "type": "array", "items": { "name": "tabs", "description": "二级 tab 数据体，tab 可以嵌套在 tab 下形成二级 tab 的效果，最多嵌套2级，可添加多个 tab 分栏并在分栏内添加除 tab 外的其他类型的尺码数据内容。 \n\n最大tab分栏数量限制：5", "type": "object", "properties": { "tab_name": { "name": "tab_name", "description": "tab 分栏的名称。\n\n最大长度限制：50", "type": "string", "example": "" }, "tab_content": { "name": "tab_content", "description": "二级 tab 数据体，tab 可以嵌套在 tab 下形成二级 tab 的效果，最多嵌套2级，可添加多个 tab 分栏并在分栏内添加除 tab 外的其他类型的尺码数据内容。 \n\n最大tab分栏数量限制：5", "type": "array", "items": { "name": "tab_content", "description": "二级 tab 数据体，tab 可以嵌套在 tab 下形成二级 tab 的效果，最多嵌套2级，可添加多个 tab 分栏并在分栏内添加除 tab 外的其他类型的尺码数据内容。 \n\n最大tab分栏数量限制：5", "type": "object", "properties": { "url": { "name": "url", "description": "图片类型内容，当 `type` 传入 `IMAGE` 时，传入图片的 URL 地址。", "type": "string", "example": "" }, "cross_table_content": { "name": "cross_table_content", "description": "交叉表格类型的数据体，常用于显示不同身体参数适合的具体尺码。例如身高170cm，体重70kg适用L。", "type": "object", "properties": { "column_title": { "name": "column_title", "description": "交叉表格中列的标题，用于说明列的数据代表的尺码信息。例如 `weight` 表示列的数据为体重数据。默认为 `weight`。\n\n最大长度限制：20", "type": "string", "example": "weight" }, "column_unit": { "name": "column_unit", "description": "交叉表格中列的尺码单位。", "type": "object", "properties": { "convert_unit": { "name": "convert_unit", "description": "尺码数据的可选展示单位。客户可以在默认单位（`default_unit`）和此单位之间切换展示尺码。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。默认为 `kg`。", "type": "string", "example": "kg" }, "default_unit": { "name": "default_unit", "description": "尺码数据的默认展示单位。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。 ，默认为 `lb`。", "type": "string", "example": "lb" }, "unit_type": { "name": "unit_type", "description": "交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有：\n- `LENGTH` :长度类型单位\n- `WEIGHT`（默认）：重量类型单位\n- `BULK`：体积类型单位\n\n每一种类型下支持的单位枚举如下：\n\n| 单位类型 | 单位类型描述 | 支持单位 | 支持单位描述 | \n| :--: | :--: | :--: | :--: | \n| LENGTH | 长度| feet |英尺 | \n| LENGTH | 长度| m |米 | \n| LENGTH | 长度| cm |厘米 | \n| LENGTH | 长度| mm |毫米 | \n| LENGTH | 长度| in |英寸 | \n| WEIGHT | 重量(默认)| lb | 磅 | \n| WEIGHT | 重量(默认)| oz | 盎司 | \n| WEIGHT | 重量(默认)| kg | 千克 | \n| WEIGHT | 重量(默认)| g | 克 | \n| WEIGHT | 重量(默认)| mg | 毫克 | \n| BULK | 体积 | us_gal | 加仑 (美) | \n| BULK | 体积 | uk_gal | 加仑 (英) | \n| BULK | 体积 | oz_us | 液体盎司 (美)| \n| BULK | 体积 | oz_uk | 液体盎司(英) | \n| BULK | 体积 | ml | 毫升 |\n| BULK | 体积 | l | 升 |", "type": "string", "example": "WEIGHT" } }, "example": { "unit_type": "WEIGHT", "convert_unit": "kg", "default_unit": "lb" } }, "remark": { "name": "remark", "description": "交叉表格的备注。\n\n最大长度限制：255", "type": "string", "example": "1 lb = 0.45 kg，1 feet = 30.48 cm" }, "row_title": { "name": "row_title", "description": "交叉表格中行的标题，用于说明行的数据代表的尺码信息。例如 `height` 表示行的数据为身高数据。\n\n默认为 `height`。\n\n最大长度限制：20", "type": "string", "example": "height" }, "row_unit": { "name": "row_unit", "description": "交叉表格中行的尺码单位。", "type": "object", "properties": { "unit_type": { "name": "unit_type", "description": "交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有：\n- `LENGTH` :长度类型单位\n- `WEIGHT`（默认）：重量类型单位\n- `BULK`：体积类型单位\n\n每一种类型下支持的单位枚举如下：\n\n| 单位类型 | 单位类型描述 | 支持单位 | 支持单位描述 | \n| :--: | :--: | :--: | :--: | \n| LENGTH | 长度| feet |英尺 | \n| LENGTH | 长度| m |米 | \n| LENGTH | 长度| cm |厘米 | \n| LENGTH | 长度| mm |毫米 | \n| LENGTH | 长度| in |英寸 | \n| WEIGHT | 重量(默认)| lb | 磅 | \n| WEIGHT | 重量(默认)| oz | 盎司 | \n| WEIGHT | 重量(默认)| kg | 千克 | \n| WEIGHT | 重量(默认)| g | 克 | \n| WEIGHT | 重量(默认)| mg | 毫克 | \n| BULK | 体积 | us_gal | 加仑 (美) | \n| BULK | 体积 | uk_gal | 加仑 (英) | \n| BULK | 体积 | oz_us | 液体盎司 (美)| \n| BULK | 体积 | oz_uk | 液体盎司(英) | \n| BULK | 体积 | ml | 毫升 |\n| BULK | 体积 | l | 升 |", "type": "string", "example": "LENGTH" }, "convert_unit": { "name": "convert_unit", "description": "尺码数据的可选展示单位。客户可以在默认单位（`default_unit`）和此单位之间切换展示尺码。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。默认为 `feet`。", "type": "string", "example": "feet" }, "default_unit": { "name": "default_unit", "description": "尺码数据的默认展示单位。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。 ，默认为 `cm`。", "type": "string", "example": "cm" } }, "example": { "convert_unit": "feet", "default_unit": "cm", "unit_type": "LENGTH" } }, "size_data": { "name": "size_data", "description": "交叉表格数据体，第一个元素为表头，数组中的每个元素对应表格中的一行数据。\n\n最大行数限制：50", "type": "array", "items": { "name": "size_data", "description": "交叉表格数据体，第一个元素为表头，数组中的每个元素对应表格中的一行数据。\n\n最大行数限制：50", "type": "object", "properties": { "row_data": { "name": "row_data", "description": "交叉表格行数据，数组中每个元素为一行数据中的一个单元格。\n\n每行最大单元格数：50\n\n每个单元格最大长度限制：19 ", "type": "array", "items": { "name": "row_data", "description": "交叉表格行数据，数组中每个元素为一行数据中的一个单元格。\n\n每行最大单元格数：50\n\n每个单元格最大长度限制：19 ", "type": "string", "example": "XS,64" }, "example": [ "XS,64" ] } }, "required": [ "row_data" ], "example": { "row_data": [ "XS,64" ] } }, "example": [ { "row_data": [ "XS,64" ] } ] } }, "required": [ "size_data" ], "example": { "row_unit": { "convert_unit": "feet", "default_unit": "cm", "unit_type": "LENGTH" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height" } }, "table_content": { "name": "table_content", "description": "表格类型的数据体，常用于以表格形式显示尺码数据。例如 S 的肩宽是60，腰围是55。", "type": "object", "properties": { "size_data": { "name": "size_data", "description": "表格数据体，一个数组代表表格的一行数据，第一个数组为表头，数组中的每个元素对应表格中的单元格数据。\n\n最大行数限制：50", "type": "array", "items": { "name": "size_data", "description": "表格数据体，一个数组代表表格的一行数据，第一个数组为表头，数组中的每个元素对应表格中的单元格数据。\n\n最大行数限制：50", "type": "object", "properties": { "row_data": { "name": "row_data", "description": "数组形式的表格行数据，数组中每个元素代表一个单元格。\n\n每个数组最大元素数量：50\n\n每个元素最大长度限制：19 ", "type": "array", "items": { "name": "row_data", "description": "数组形式的表格行数据，数组中每个元素代表一个单元格。\n\n每个数组最大元素数量：50\n\n每个元素最大长度限制：19 ", "type": "string", "example": "XS,64" }, "example": [ "XS,64" ] } }, "required": [ "row_data" ], "example": { "row_data": [ "XS,64" ] } }, "example": [ { "row_data": [ "XS,64" ] } ] }, "unit": { "name": "unit", "description": "表格的尺码数据使用的单位。", "type": "object", "properties": { "convert_unit": { "name": "convert_unit", "description": "尺码数据的可选展示单位。客户可以在默认单位（`default_unit`）和此单位之间切换展示尺码。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。默认为 `in`。", "type": "string", "example": "in" }, "default_unit": { "name": "default_unit", "description": "尺码数据的默认展示单位。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。 ，默认为 `cm`。", "type": "string", "example": "cm" }, "unit_type": { "name": "unit_type", "description": "表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有：\n- `LENGTH` :长度类型单位\n- `WEIGHT`（默认）：重量类型单位\n- `BULK`：体积类型单位\n\n每一种类型下支持的单位枚举如下：\n\n| 单位类型 | 单位类型描述 | 支持单位 | 支持单位描述 | \n| :--: | :--: | :--: | :--: | \n| LENGTH | 长度| feet |英尺 | \n| LENGTH | 长度| m |米 | \n| LENGTH | 长度| cm |厘米 | \n| LENGTH | 长度| mm |毫米 | \n| LENGTH | 长度| in |英寸 | \n| WEIGHT | 重量(默认)| lb | 磅 | \n| WEIGHT | 重量(默认)| oz | 盎司 | \n| WEIGHT | 重量(默认)| kg | 千克 | \n| WEIGHT | 重量(默认)| g | 克 | \n| WEIGHT | 重量(默认)| mg | 毫克 | \n| BULK | 体积 | us_gal | 加仑 (美) | \n| BULK | 体积 | uk_gal | 加仑 (英) | \n| BULK | 体积 | oz_us | 液体盎司 (美)| \n| BULK | 体积 | oz_uk | 液体盎司(英) | \n| BULK | 体积 | ml | 毫升 |\n| BULK | 体积 | l | 升 |", "type": "string", "example": "LENGTH" } }, "example": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" } }, "country_size": { "name": "country_size", "description": "国家尺码数据，代表此表格内的尺码在不同国家下的名称。", "type": "object", "properties": { "cover_attribute": { "name": "cover_attribute", "description": "是否覆盖尺码规格文案，传入 `true` 时将使用国家尺码名称替代页面上的尺码属性值进行展示。\n\n● `true`：表示覆盖\n \n● `false`：表示不覆盖\n \n默认取值为 `false`\n\n", "type": "boolean", "example": false }, "status": { "name": "status", "description": "是否开启国家尺码功能开关。\n\n● `true`：表示开启功能\n \n● `false`：表示不开启功能\n\n默认取值为`false`", "type": "boolean", "example": true }, "country_size_data": { "name": "country_size_data", "description": "国家尺码数据, 数组的第一个元素代表国家，其他元素代表不同尺码在这个国家的名称。", "type": "array", "items": { "name": "country_size_data", "description": "国家尺码数据, 数组的第一个元素代表国家，其他元素代表不同尺码在这个国家的名称。", "type": "object", "properties": { "country": { "name": "country", "description": "国家名称。\n\n最大长度限制：19", "type": "string", "example": "US" }, "data": { "name": "data", "description": "表格中不同尺码在当前国家的名称数组。\n\n数组中每个元素最大长度限制：19", "type": "array", "items": { "name": "data", "description": "表格中不同尺码在当前国家的名称数组。\n\n数组中每个元素最大长度限制：19", "type": "string", "example": "78,89" }, "example": [ "78,89" ] } }, "required": [ "country", "data" ], "example": { "country": "US", "data": [ "78,89" ] } }, "example": [ { "country": "US", "data": [ "78,89" ] } ] } }, "required": [ "country_size_data" ], "example": { "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true } }, "remark": { "name": "remark", "description": "表格备注。\n\n最大长度限制：255", "type": "string", "example": "1inch=2.54cm" } }, "required": [ "size_data" ], "example": { "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" }, "country_size": { "status": true, "country_size_data": [ { "data": [ "78,89" ], "country": "US" } ], "cover_attribute": false } } }, "text": { "name": "text", "description": "文本类型内容。", "type": "string", "example": "My SizeChart" }, "title": { "name": "title", "description": "尺码表格标题，超过长度限制会被截断。\n\n最大长度限制：50", "type": "string", "example": "" }, "type": { "name": "type", "description": "二级 tab 中支持的内容类型枚举，枚举值如下所示：\n\n- `SIZE_CHART`：表格类型\n- `CROSS_SIZE_CHART`：交叉表格类型\n- `IMAGE`：图片类型\n- `TEXT`：文本类型", "type": "string", "example": "" } }, "required": [ "type" ], "example": { "title": "", "type": "", "url": "", "cross_table_content": { "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "feet" }, "size_data": [ { "row_data": [ "XS,64" ] } ] }, "table_content": { "unit": { "unit_type": "LENGTH", "convert_unit": "in", "default_unit": "cm" }, "country_size": { "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ] }, "text": "My SizeChart" } }, "example": [ { "url": "", "cross_table_content": { "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "unit_type": "WEIGHT", "convert_unit": "kg", "default_unit": "lb" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "unit_type": "LENGTH", "convert_unit": "feet", "default_unit": "cm" } }, "table_content": { "unit": { "unit_type": "LENGTH", "convert_unit": "in", "default_unit": "cm" }, "country_size": { "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ] }, "text": "My SizeChart", "title": "", "type": "" } ] } }, "required": [ "tab_name" ], "example": { "tab_content": [ { "type": "", "url": "", "cross_table_content": { "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "unit_type": "LENGTH", "convert_unit": "feet", "default_unit": "cm" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "unit_type": "WEIGHT", "convert_unit": "kg", "default_unit": "lb" } }, "table_content": { "country_size": { "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "in" } }, "text": "My SizeChart", "title": "" } ], "tab_name": "" } }, "example": [ { "tab_content": [ { "cross_table_content": { "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "convert_unit": "feet", "default_unit": "cm", "unit_type": "LENGTH" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "unit_type": "WEIGHT", "convert_unit": "kg", "default_unit": "lb" } }, "table_content": { "country_size": { "country_size_data": [ { "data": [ "78,89" ], "country": "US" } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" } }, "text": "My SizeChart", "title": "", "type": "", "url": "" } ], "tab_name": "" } ] }, "text": { "name": "text", "description": "文本类型内容。", "type": "string", "example": "My SizeChart" }, "title": { "name": "title", "description": "尺码表格标题，超过长度限制会被截断。\n\n最大长度限制：50", "type": "string", "example": "Size Chart" }, "type": { "name": "type", "description": "tab 中支持的内容类型枚举，枚举值如下所示：\n\n- `SIZE_CHART`：表格类型\n- `CROSS_SIZE_CHART`：交叉表格类型\n- `IMAGE`：图片类型\n- `TEXT`：文本类型\n- `TAB`：Tab类型", "type": "string", "example": "SIZE_CHART" }, "url": { "name": "url", "description": "图片类型内容，当 `type` 传入 `IMAGE` 时，传入图片的 URL 地址。", "type": "string", "example": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png" }, "cross_table_content": { "name": "cross_table_content", "description": "交叉表格类型的数据体，常用于显示不同身体参数适合的具体尺码。例如身高170cm，体重70kg适用L。", "type": "object", "properties": { "column_title": { "name": "column_title", "description": "交叉表格中列的标题，用于说明列的数据代表的尺码信息。例如 `weight` 表示列的数据为体重数据。默认为 `weight`。\n\n最大长度限制：20", "type": "string", "example": "weight" }, "column_unit": { "name": "column_unit", "description": "交叉表格中列的尺码单位。", "type": "object", "properties": { "default_unit": { "name": "default_unit", "description": "尺码数据的默认展示单位。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。 ，默认为 `lb`。", "type": "string", "example": "lb" }, "unit_type": { "name": "unit_type", "description": "交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有：\n- `LENGTH` :长度类型单位\n- `WEIGHT`（默认）：重量类型单位\n- `BULK`：体积类型单位\n\n每一种类型下支持的单位枚举如下：\n\n| 单位类型 | 单位类型描述 | 支持单位 | 支持单位描述 | \n| :--: | :--: | :--: | :--: | \n| LENGTH | 长度| feet |英尺 | \n| LENGTH | 长度| m |米 | \n| LENGTH | 长度| cm |厘米 | \n| LENGTH | 长度| mm |毫米 | \n| LENGTH | 长度| in |英寸 | \n| WEIGHT | 重量(默认)| lb | 磅 | \n| WEIGHT | 重量(默认)| oz | 盎司 | \n| WEIGHT | 重量(默认)| kg | 千克 | \n| WEIGHT | 重量(默认)| g | 克 | \n| WEIGHT | 重量(默认)| mg | 毫克 | \n| BULK | 体积 | us_gal | 加仑 (美) | \n| BULK | 体积 | uk_gal | 加仑 (英) | \n| BULK | 体积 | oz_us | 液体盎司 (美)| \n| BULK | 体积 | oz_uk | 液体盎司(英) | \n| BULK | 体积 | ml | 毫升 |\n| BULK | 体积 | l | 升 |", "type": "string", "example": "WEIGHT" }, "convert_unit": { "name": "convert_unit", "description": "尺码数据的可选展示单位。客户可以在默认单位（`default_unit`）和此单位之间切换展示尺码。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。默认为 `kg`。", "type": "string", "example": "kg" } }, "example": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" } }, "remark": { "name": "remark", "description": "交叉表格的备注。\n\n最大长度限制：255", "type": "string", "example": "1 lb = 0.45 kg，1 feet = 30.48 cm" }, "row_title": { "name": "row_title", "description": "交叉表格中行的标题，用于说明行的数据代表的尺码信息。例如 `height` 表示行的数据为身高数据。\n\n默认为 `height`。\n\n最大长度限制：20", "type": "string", "example": "height" }, "row_unit": { "name": "row_unit", "description": "交叉表格中行的尺码单位。", "type": "object", "properties": { "default_unit": { "name": "default_unit", "description": "尺码数据的默认展示单位。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。 ，默认为 `cm`。", "type": "string", "example": "cm" }, "unit_type": { "name": "unit_type", "description": "交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有：\n- `LENGTH` :长度类型单位\n- `WEIGHT`（默认）：重量类型单位\n- `BULK`：体积类型单位\n\n每一种类型下支持的单位枚举如下：\n\n| 单位类型 | 单位类型描述 | 支持单位 | 支持单位描述 | \n| :--: | :--: | :--: | :--: | \n| LENGTH | 长度| feet |英尺 | \n| LENGTH | 长度| m |米 | \n| LENGTH | 长度| cm |厘米 | \n| LENGTH | 长度| mm |毫米 | \n| LENGTH | 长度| in |英寸 | \n| WEIGHT | 重量(默认)| lb | 磅 | \n| WEIGHT | 重量(默认)| oz | 盎司 | \n| WEIGHT | 重量(默认)| kg | 千克 | \n| WEIGHT | 重量(默认)| g | 克 | \n| WEIGHT | 重量(默认)| mg | 毫克 | \n| BULK | 体积 | us_gal | 加仑 (美) | \n| BULK | 体积 | uk_gal | 加仑 (英) | \n| BULK | 体积 | oz_us | 液体盎司 (美)| \n| BULK | 体积 | oz_uk | 液体盎司(英) | \n| BULK | 体积 | ml | 毫升 |\n| BULK | 体积 | l | 升 |", "type": "string", "example": "LENGTH" }, "convert_unit": { "name": "convert_unit", "description": "尺码数据的可选展示单位。客户可以在默认单位（`default_unit`）和此单位之间切换展示尺码。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。默认为 `feet`。", "type": "string", "example": "feet" } }, "example": { "convert_unit": "feet", "default_unit": "cm", "unit_type": "LENGTH" } }, "size_data": { "name": "size_data", "description": "交叉表格数据体，第一个元素为表头，数组中的每个元素对应表格中的一行数据。\n\n最大行数限制：50", "type": "array", "items": { "name": "size_data", "description": "交叉表格数据体，第一个元素为表头，数组中的每个元素对应表格中的一行数据。\n\n最大行数限制：50", "type": "object", "properties": { "row_data": { "name": "row_data", "description": "交叉表格数据体，第一个元素为表头, 数组中的每个元素对应表格中的一行数据。\n\n最大行数限制：50", "type": "array", "items": { "name": "row_data", "description": "交叉表格数据体，第一个元素为表头, 数组中的每个元素对应表格中的一行数据。\n\n最大行数限制：50", "type": "string", "example": "XS,64" }, "example": [ "XS,64" ] } }, "required": [ "row_data" ], "example": { "row_data": [ "XS,64" ] } }, "example": [ { "row_data": [ "XS,64" ] } ] } }, "required": [ "size_data" ], "example": { "row_title": "height", "row_unit": { "unit_type": "LENGTH", "convert_unit": "feet", "default_unit": "cm" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "default_unit": "lb", "unit_type": "WEIGHT", "convert_unit": "kg" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm" } }, "table_content": { "name": "table_content", "description": "表格类型的数据体，常用于以表格形式显示尺码数据。例如 S 的肩宽是60，腰围是55。", "type": "object", "properties": { "unit": { "name": "unit", "description": "表格的尺码数据使用的单位。", "type": "object", "properties": { "unit_type": { "name": "unit_type", "description": "表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有：\n- `LENGTH` :长度类型单位\n- `WEIGHT`（默认）：重量类型单位\n- `BULK`：体积类型单位\n\n每一种类型下支持的单位枚举如下：\n\n| 单位类型 | 单位类型描述 | 支持单位 | 支持单位描述 | \n| :--: | :--: | :--: | :--: | \n| LENGTH | 长度| feet |英尺 | \n| LENGTH | 长度| m |米 | \n| LENGTH | 长度| cm |厘米 | \n| LENGTH | 长度| mm |毫米 | \n| LENGTH | 长度| in |英寸 | \n| WEIGHT | 重量(默认)| lb | 磅 | \n| WEIGHT | 重量(默认)| oz | 盎司 | \n| WEIGHT | 重量(默认)| kg | 千克 | \n| WEIGHT | 重量(默认)| g | 克 | \n| WEIGHT | 重量(默认)| mg | 毫克 | \n| BULK | 体积 | us_gal | 加仑 (美) | \n| BULK | 体积 | uk_gal | 加仑 (英) | \n| BULK | 体积 | oz_us | 液体盎司 (美)| \n| BULK | 体积 | oz_uk | 液体盎司(英) | \n| BULK | 体积 | ml | 毫升 |\n| BULK | 体积 | l | 升 |", "type": "string", "example": "" }, "convert_unit": { "name": "convert_unit", "description": "尺码数据的可选展示单位。客户可以在默认单位（`default_unit`）和此单位之间切换展示尺码。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。默认为 `in`。", "type": "string", "example": "" }, "default_unit": { "name": "default_unit", "description": "尺码数据的默认展示单位。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。 ，默认为 `cm`。", "type": "string", "example": "" } }, "example": { "unit_type": "", "convert_unit": "", "default_unit": "" } }, "country_size": { "name": "country_size", "description": "国家尺码数据，代表此表格内的尺码在不同国家下的名称。", "type": "object", "properties": { "status": { "name": "status", "description": "是否开启国家尺码功能开关。\n\n● `true`：表示开启功能\n \n● `false`：表示不开启功能\n\n默认值为:`false`", "type": "boolean", "example": true }, "country_size_data": { "name": "country_size_data", "description": "国家尺码数据, 数组的第一个元素代表国家，其他元素代表不同尺码在这个国家的名称。", "type": "array", "items": { "name": "country_size_data", "description": "国家尺码数据, 数组的第一个元素代表国家，其他元素代表不同尺码在这个国家的名称。", "type": "object", "properties": { "country": { "name": "country", "description": "国家名称。\n\n最大长度限制：19", "type": "string", "example": "US" }, "data": { "name": "data", "description": "表格中不同尺码在当前国家的名称数组。\n\n最大个数限制：21\n\n数组中每个元素最大长度限制：19", "type": "array", "items": { "name": "data", "description": "表格中不同尺码在当前国家的名称数组。\n\n最大个数限制：21\n\n数组中每个元素最大长度限制：19", "type": "string", "example": "78,89" }, "example": [ "78,89" ] } }, "required": [ "country", "data" ], "example": { "data": [ "78,89" ], "country": "US" } }, "example": [ { "data": [ "78,89" ], "country": "US" } ] }, "cover_attribute": { "name": "cover_attribute", "description": "是否覆盖尺码规格文案，传入 `true` 时将使用国家尺码名称替代页面上的尺码属性值进行展示。\n\n● `true`：表示覆盖\n \n● `false`：表示不覆盖\n \n默认取值为 `false`\n\n", "type": "boolean", "example": false } }, "required": [ "country_size_data" ], "example": { "country_size_data": [ { "data": [ "78,89" ], "country": "US" } ], "cover_attribute": false, "status": true } }, "remark": { "name": "remark", "description": "表格备注。\n\n最大长度限制：255", "type": "string", "example": "1inch=2.54cm" }, "size_data": { "name": "size_data", "description": "表格数据体，一个数组代表表格的一行数据，第一个数组为表头，数组中的每个元素对应表格中的单元格数据。\n\n最大行数限制：50", "type": "array", "items": { "name": "size_data", "description": "表格数据体，一个数组代表表格的一行数据，第一个数组为表头，数组中的每个元素对应表格中的单元格数据。\n\n最大行数限制：50", "type": "object", "properties": { "row_data": { "name": "row_data", "description": "数组形式的表格行数据，数组中每个元素代表一个单元格。\n\n每个数组最大元素数量：50\n\n每个元素最大长度限制：19 ", "type": "array", "items": { "name": "row_data", "description": "数组形式的表格行数据，数组中每个元素代表一个单元格。\n\n每个数组最大元素数量：50\n\n每个元素最大长度限制：19 ", "type": "string", "example": "XS,64" }, "example": [ "XS,64" ] } }, "required": [ "row_data" ], "example": { "row_data": [ "XS,64" ] } }, "example": [ { "row_data": [ "XS,64" ] } ] } }, "required": [ "size_data" ], "example": { "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "unit_type": "", "convert_unit": "", "default_unit": "" }, "country_size": { "cover_attribute": false, "status": true, "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ] }, "remark": "1inch=2.54cm" } } }, "required": [ "type" ], "example": { "cross_table_content": { "row_title": "height", "row_unit": { "unit_type": "LENGTH", "convert_unit": "feet", "default_unit": "cm" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm" }, "table_content": { "unit": { "default_unit": "", "unit_type": "", "convert_unit": "" }, "country_size": { "country_size_data": [ { "data": [ "78,89" ], "country": "US" } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ] }, "tabs": [ { "tab_content": [ { "table_content": { "country_size": { "status": true, "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "in" } }, "text": "My SizeChart", "title": "", "type": "", "url": "", "cross_table_content": { "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "feet" }, "size_data": [ { "row_data": [ "XS,64" ] } ] } } ], "tab_name": "" } ], "text": "My SizeChart", "title": "Size Chart", "type": "SIZE_CHART", "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png" } }, "example": [ { "table_content": { "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "default_unit": "", "unit_type": "", "convert_unit": "" }, "country_size": { "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm" }, "tabs": [ { "tab_content": [ { "text": "My SizeChart", "title": "", "type": "", "url": "", "cross_table_content": { "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "feet" } }, "table_content": { "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "in" }, "country_size": { "cover_attribute": false, "status": true, "country_size_data": [ { "data": [ "78,89" ], "country": "US" } ] }, "remark": "1inch=2.54cm" } } ], "tab_name": "" } ], "text": "My SizeChart", "title": "Size Chart", "type": "SIZE_CHART", "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png", "cross_table_content": { "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "feet" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "unit_type": "WEIGHT", "convert_unit": "kg", "default_unit": "lb" } } } ] }, "tab_name": { "name": "tab_name", "description": "tab 分栏的名称。\n\n最大长度限制：50", "type": "string", "example": "" } }, "required": [ "tab_name" ], "example": { "tab_content": [ { "tabs": [ { "tab_content": [ { "table_content": { "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "in" }, "country_size": { "cover_attribute": false, "status": true, "country_size_data": [ { "data": [ "78,89" ], "country": "US" } ] }, "remark": "1inch=2.54cm" }, "text": "My SizeChart", "title": "", "type": "", "url": "", "cross_table_content": { "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "convert_unit": "feet", "default_unit": "cm", "unit_type": "LENGTH" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight" } } ], "tab_name": "" } ], "text": "My SizeChart", "title": "Size Chart", "type": "SIZE_CHART", "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png", "cross_table_content": { "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "feet" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" } }, "table_content": { "country_size": { "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "default_unit": "", "unit_type": "", "convert_unit": "" } } } ], "tab_name": "" } }, "example": [ { "tab_content": [ { "title": "Size Chart", "type": "SIZE_CHART", "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png", "cross_table_content": { "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "convert_unit": "feet", "default_unit": "cm", "unit_type": "LENGTH" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" } }, "table_content": { "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "default_unit": "", "unit_type": "", "convert_unit": "" }, "country_size": { "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm" }, "tabs": [ { "tab_content": [ { "title": "", "type": "", "url": "", "cross_table_content": { "row_title": "height", "row_unit": { "convert_unit": "feet", "default_unit": "cm", "unit_type": "LENGTH" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "default_unit": "lb", "unit_type": "WEIGHT", "convert_unit": "kg" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm" }, "table_content": { "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "unit_type": "LENGTH", "convert_unit": "in", "default_unit": "cm" }, "country_size": { "cover_attribute": false, "status": true, "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ] }, "remark": "1inch=2.54cm" }, "text": "My SizeChart" } ], "tab_name": "" } ], "text": "My SizeChart" } ], "tab_name": "" } ] }, "text": { "name": "text", "description": "文本类型内容。", "type": "string", "example": "My SizeChart" }, "title": { "name": "title", "description": "尺码表标题，超过长度限制会被截断。\n\n最大长度限制：50", "type": "string", "example": "Size Chart" }, "type": { "name": "type", "description": "尺码表中支持的内容类型枚举，枚举值如下所示：\n\n- `SIZE_CHART`：表格类型\n- `CROSS_SIZE_CHART`：交叉表格类型 \n- `IMAGE`：图片类型\n- `TEXT`：文本类型\n- `TAB`：Tab 类型", "type": "string", "example": "SIZE_CHART" }, "url": { "name": "url", "description": "图片类型内容，当 `type` 传入 `IMAGE` 时，传入图片的 URL 地址。", "type": "string", "example": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png" }, "cross_table_content": { "name": "cross_table_content", "description": "交叉表格类型的数据体，常用于显示不同身体参数适合的具体尺码。例如身高170cm，体重70kg适用L。", "type": "object", "properties": { "row_unit": { "name": "row_unit", "description": "交叉表格中行的尺码单位。", "type": "object", "properties": { "convert_unit": { "name": "convert_unit", "description": "尺码数据的可选展示单位。客户可以在默认单位（`default_unit`）和此单位之间切换展示尺码。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。默认为 `feet`。", "type": "string", "example": "feet" }, "default_unit": { "name": "default_unit", "description": "尺码数据的默认展示单位。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。 ，默认为 `cm`。", "type": "string", "example": "cm" }, "unit_type": { "name": "unit_type", "description": "交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有：\n- `LENGTH` :长度类型单位\n- `WEIGHT`（默认）：重量类型单位\n- `BULK`：体积类型单位\n\n每一种类型下支持的单位枚举如下：\n\n| 单位类型 | 单位类型描述 | 支持单位 | 支持单位描述 | \n| :--: | :--: | :--: | :--: | \n| LENGTH | 长度| feet |英尺 | \n| LENGTH | 长度| m |米 | \n| LENGTH | 长度| cm |厘米 | \n| LENGTH | 长度| mm |毫米 | \n| LENGTH | 长度| in |英寸 | \n| WEIGHT | 重量(默认)| lb | 磅 | \n| WEIGHT | 重量(默认)| oz | 盎司 | \n| WEIGHT | 重量(默认)| kg | 千克 | \n| WEIGHT | 重量(默认)| g | 克 | \n| WEIGHT | 重量(默认)| mg | 毫克 | \n| BULK | 体积 | us_gal | 加仑 (美) | \n| BULK | 体积 | uk_gal | 加仑 (英) | \n| BULK | 体积 | oz_us | 液体盎司 (美)| \n| BULK | 体积 | oz_uk | 液体盎司(英) | \n| BULK | 体积 | ml | 毫升 |\n| BULK | 体积 | l | 升 |", "type": "string", "example": "LENGTH" } }, "example": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "feet" } }, "size_data": { "name": "size_data", "description": "交叉表格数据体，第一个元素为表头，数组中的每个元素对应表格中的一行数据。\n\n最大个数限制：50", "type": "array", "items": { "name": "size_data", "description": "交叉表格数据体，第一个元素为表头，数组中的每个元素对应表格中的一行数据。\n\n最大个数限制：50", "type": "object", "properties": { "row_data": { "name": "row_data", "description": "交叉表格行数据，数组中每个元素为一行数据中的一个单元格。\n\n每行最大单元格数：50\n\n每个单元格最大长度限制：19 ", "type": "array", "items": { "name": "row_data", "description": "交叉表格行数据，数组中每个元素为一行数据中的一个单元格。\n\n每行最大单元格数：50\n\n每个单元格最大长度限制：19 ", "type": "string", "example": "XS,64" }, "example": [ "XS,64" ] } }, "required": [ "row_data" ], "example": { "row_data": [ "XS,64" ] } }, "example": [ { "row_data": [ "XS,64" ] } ] }, "column_title": { "name": "column_title", "description": "交叉表格中列的标题，用于说明列的数据代表的尺码信息。例如 `weight` 表示列的数据为体重数据。默认为 `weight`。\n\n最大长度限制：20", "type": "string", "example": "weight" }, "column_unit": { "name": "column_unit", "description": "交叉表格中列的尺码单位。", "type": "object", "properties": { "default_unit": { "name": "default_unit", "description": "尺码数据的默认展示单位。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。 ，默认为 `lb`。", "type": "string", "example": "lb" }, "unit_type": { "name": "unit_type", "description": "交叉表格支持的单位类型以及每一种类型中具体的度量单位。支持的单位类型有：\n- `LENGTH` :长度类型单位\n- `WEIGHT`（默认）：重量类型单位\n- `BULK`：体积类型单位\n\n每一种类型下支持的单位枚举如下：\n\n| 单位类型 | 单位类型描述 | 支持单位 | 支持单位描述 | \n| :--: | :--: | :--: | :--: | \n| LENGTH | 长度| feet |英尺 | \n| LENGTH | 长度| m |米 | \n| LENGTH | 长度| cm |厘米 | \n| LENGTH | 长度| mm |毫米 | \n| LENGTH | 长度| in |英寸 | \n| WEIGHT | 重量(默认)| lb | 磅 | \n| WEIGHT | 重量(默认)| oz | 盎司 | \n| WEIGHT | 重量(默认)| kg | 千克 | \n| WEIGHT | 重量(默认)| g | 克 | \n| WEIGHT | 重量(默认)| mg | 毫克 | \n| BULK | 体积 | us_gal | 加仑 (美) | \n| BULK | 体积 | uk_gal | 加仑 (英) | \n| BULK | 体积 | oz_us | 液体盎司 (美)| \n| BULK | 体积 | oz_uk | 液体盎司(英) | \n| BULK | 体积 | ml | 毫升 |\n| BULK | 体积 | l | 升 |", "type": "string", "example": "WEIGHT" }, "convert_unit": { "name": "convert_unit", "description": "尺码数据的可选展示单位。客户可以在默认单位（`default_unit`）和此单位之间切换展示尺码。\n该字段有效值请参考 `unit_type` 描述中的表格信息，你需要根据指定的 `unit_type` 传入支持的单位。默认为 `kg`。", "type": "string", "example": "kg" } }, "example": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" } }, "remark": { "name": "remark", "description": "交叉表格的备注。\n\n最大长度限制：255", "type": "string", "example": "1 lb = 0.45 kg，1 feet = 30.48 cm" }, "row_title": { "name": "row_title", "description": "交叉表格中行的标题，用于说明行的数据代表的尺码信息。例如 `height` 表示行的数据为身高数据。\n\n默认为 `height`。\n\n最大长度限制：20", "type": "string", "example": "height" } }, "required": [ "size_data" ], "example": { "row_unit": { "unit_type": "LENGTH", "convert_unit": "feet", "default_unit": "cm" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height" } } }, "required": [ "type" ], "example": { "table_content": { "country_size": { "cover_attribute": false, "status": true, "country_size_data": [ { "country": "United States", "data": [ "78,89" ] } ] }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" } }, "tabs": [ { "tab_content": [ { "type": "SIZE_CHART", "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png", "cross_table_content": { "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "convert_unit": "feet", "default_unit": "cm", "unit_type": "LENGTH" } }, "table_content": { "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "convert_unit": "", "default_unit": "", "unit_type": "" }, "country_size": { "cover_attribute": false, "status": true, "country_size_data": [ { "data": [ "78,89" ], "country": "US" } ] }, "remark": "1inch=2.54cm" }, "tabs": [ { "tab_name": "", "tab_content": [ { "cross_table_content": { "row_title": "height", "row_unit": { "unit_type": "LENGTH", "convert_unit": "feet", "default_unit": "cm" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm" }, "table_content": { "unit": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" }, "country_size": { "country_size_data": [ { "data": [ "78,89" ], "country": "US" } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ] }, "text": "My SizeChart", "title": "", "type": "", "url": "" } ] } ], "text": "My SizeChart", "title": "Size Chart" } ], "tab_name": "" } ], "text": "My SizeChart", "title": "Size Chart", "type": "SIZE_CHART", "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png", "cross_table_content": { "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "feet" } } } }, "example": [ { "title": "Size Chart", "type": "SIZE_CHART", "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png", "cross_table_content": { "column_unit": { "unit_type": "WEIGHT", "convert_unit": "kg", "default_unit": "lb" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "convert_unit": "feet", "default_unit": "cm", "unit_type": "LENGTH" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight" }, "table_content": { "country_size": { "country_size_data": [ { "data": [ "78,89" ], "country": "United States" } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" } }, "tabs": [ { "tab_name": "", "tab_content": [ { "type": "SIZE_CHART", "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png", "cross_table_content": { "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "unit_type": "LENGTH", "convert_unit": "feet", "default_unit": "cm" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" } }, "table_content": { "country_size": { "status": true, "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "convert_unit": "", "default_unit": "", "unit_type": "" } }, "tabs": [ { "tab_content": [ { "table_content": { "country_size": { "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "in" } }, "text": "My SizeChart", "title": "", "type": "", "url": "", "cross_table_content": { "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "feet" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight" } } ], "tab_name": "" } ], "text": "My SizeChart", "title": "Size Chart" } ] } ], "text": "My SizeChart" } ] }, "status": { "name": "status", "description": "尺码表的发布状态。\n\n- `true`: 表示发布尺码表\n- `false`: 表示不发布尺码表\n\n默认值为：`false`", "type": "boolean", "example": false }, "applicable_attribute_list": { "name": "applicable_attribute_list", "description": "是一个尺码表适用商品属性的列表，每个属性可以用来描述商品的特征，如 `size` 等。\n\n单个变体属性名称长度限制：255\n\n最大个数限制：50 ", "type": "array", "items": { "name": "applicable_attribute_list", "description": "是一个尺码表适用商品属性的列表，每个属性可以用来描述商品的特征，如 `size` 等。\n\n单个变体属性名称长度限制：255\n\n最大个数限制：50 ", "type": "string", "example": "size" }, "example": [ "size" ] }, "language_scope": { "name": "language_scope", "description": "将尺码表与语言进行匹配的方法类型，当`language_scope`=`SPECIFIC` 时，`languages` 不能为空，需通过 `languages` 指定支持的语言。枚举值类型如下：\n- `ALL`: 全部语言\n- `SPECIFIC`: 指定语言\n\n默认为: `ALL`\n\n", "type": "string", "example": "ALL" }, "product_list": { "name": "product_list", "description": "当 `applicable_product_type` 传入 `SPECIFIC` 时，使用此字段传入尺码表匹配的商品 ID 列表。\n\n最大数量限制：100", "type": "array", "items": { "name": "product_list", "description": "当 `applicable_product_type` 传入 `SPECIFIC` 时，使用此字段传入尺码表匹配的商品 ID 列表。\n\n最大数量限制：100", "type": "string", "example": "16064649853088531841170520" }, "example": [ "16064649853088531841170520" ] }, "size_chart_id": { "name": "size_chart_id", "description": "尺码表的唯一 ID。", "type": "string", "example": "13266288837293171311580520" }, "applicable_product_type": { "name": "applicable_product_type", "description": "将尺码表与商品进行匹配的方法类型。\n- `ALL`：适用所有商品\n- `SPECIFIC`：适用于指定商品\n- `COLLECTION`：适用于指定商品分类\n\n默认值：`ALL`", "type": "string", "example": "ALL" } }, "required": [ "size_chart_id" ], "example": { "collection_list": [ "12260895952237462871473144" ], "status": false, "languages": [ "EN,CN" ], "product_list": [ "16064649853088531841170520" ], "applicable_product_type": "ALL", "applicable_attribute_list": [ "size" ], "contents": [ { "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png", "cross_table_content": { "row_title": "height", "row_unit": { "convert_unit": "feet", "default_unit": "cm", "unit_type": "LENGTH" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm" }, "table_content": { "unit": { "unit_type": "LENGTH", "convert_unit": "in", "default_unit": "cm" }, "country_size": { "country_size_data": [ { "country": "United States", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ] }, "tabs": [ { "tab_content": [ { "title": "Size Chart", "type": "SIZE_CHART", "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png", "cross_table_content": { "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "feet" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight" }, "table_content": { "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "convert_unit": "", "default_unit": "", "unit_type": "" }, "country_size": { "country_size_data": [ { "data": [ "78,89" ], "country": "US" } ], "cover_attribute": false, "status": true } }, "tabs": [ { "tab_name": "", "tab_content": [ { "type": "", "url": "", "cross_table_content": { "row_unit": { "unit_type": "LENGTH", "convert_unit": "feet", "default_unit": "cm" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "default_unit": "lb", "unit_type": "WEIGHT", "convert_unit": "kg" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height" }, "table_content": { "unit": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" }, "country_size": { "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ] }, "text": "My SizeChart", "title": "" } ] } ], "text": "My SizeChart" } ], "tab_name": "" } ], "text": "My SizeChart", "title": "Size Chart", "type": "SIZE_CHART" } ], "size_chart_id": "13266288837293171311580520", "language_scope": "ALL", "title": "My SizeChart" } } }, "example": { "req": { "applicable_product_type": "ALL", "title": "My SizeChart", "contents": [ { "cross_table_content": { "row_title": "height", "row_unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "feet" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "unit_type": "WEIGHT", "convert_unit": "kg", "default_unit": "lb" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm" }, "table_content": { "country_size": { "country_size_data": [ { "country": "United States", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true }, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" } }, "tabs": [ { "tab_content": [ { "table_content": { "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "default_unit": "", "unit_type": "", "convert_unit": "" }, "country_size": { "cover_attribute": false, "status": true, "country_size_data": [ { "data": [ "78,89" ], "country": "US" } ] }, "remark": "1inch=2.54cm" }, "tabs": [ { "tab_name": "", "tab_content": [ { "type": "", "url": "", "cross_table_content": { "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "convert_unit": "feet", "default_unit": "cm", "unit_type": "LENGTH" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight", "column_unit": { "default_unit": "lb", "unit_type": "WEIGHT", "convert_unit": "kg" } }, "table_content": { "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "XS,64" ] } ], "unit": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" }, "country_size": { "country_size_data": [ { "country": "US", "data": [ "78,89" ] } ], "cover_attribute": false, "status": true } }, "text": "My SizeChart", "title": "" } ] } ], "text": "My SizeChart", "title": "Size Chart", "type": "SIZE_CHART", "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png", "cross_table_content": { "column_unit": { "unit_type": "WEIGHT", "convert_unit": "kg", "default_unit": "lb" }, "remark": "1 lb = 0.45 kg，1 feet = 30.48 cm", "row_title": "height", "row_unit": { "unit_type": "LENGTH", "convert_unit": "feet", "default_unit": "cm" }, "size_data": [ { "row_data": [ "XS,64" ] } ], "column_title": "weight" } } ], "tab_name": "" } ], "text": "My SizeChart", "title": "Size Chart", "type": "SIZE_CHART", "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png" } ], "languages": [ "EN,CN" ], "size_chart_id": "13266288837293171311580520", "language_scope": "ALL", "product_list": [ "16064649853088531841170520" ], "collection_list": [ "12260895952237462871473144" ], "status": false, "applicable_attribute_list": [ "size" ] } } }, "examples": { "更新尺码表": { "description": "更新尺码表，商品将优先使用最新更新的尺码数据进行展示。", "value": { "req": { "status": true, "languages": [ "en" ], "collection_list": null, "contents": [ { "text": null, "title": "Size Chart", "type": "SIZE_CHART", "url": null, "cross_table_content": null, "table_content": { "unit": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" }, "country_size": null, "remark": "1inch=2.54cm", "size_data": [ { "row_data": [ "SIZE", "LENGTH", "BUST", "SHOULDER", "SLEEVE" ] }, { "row_data": [ "XS", "64", "91", "35", "53" ] }, { "row_data": [ "S", "66", "94", "35.5", "56" ] }, { "row_data": [ "M", "69", "96", "36.5", "58" ] }, { "row_data": [ "L", "71", "98", "38", "60" ] } ] }, "tabs": null }, { "type": "TEXT", "url": null, "cross_table_content": null, "table_content": null, "tabs": null, "text": "

Sizes can vary from 2-3 centimeters because they are measured by hand. 

", "title": null }, { "url": "https://cdn.myshopline.com/image/size-chart/detail/content_model.png", "cross_table_content": null, "table_content": null, "tabs": null, "text": null, "title": null, "type": "IMAGE" }, { "tabs": null, "text": null, "title": "Cross Size Chart", "type": "CROSS_SIZE_CHART", "url": null, "cross_table_content": { "column_title": "weight", "column_unit": { "convert_unit": "kg", "default_unit": "lb", "unit_type": "WEIGHT" }, "remark": null, "row_title": "height", "row_unit": { "default_unit": "cm", "unit_type": "LENGTH", "convert_unit": "feet" }, "size_data": [ { "row_data": [ "", "170-180", "180-190", "190-200" ] }, { "row_data": [ "60-70", "L", "XL", "XXL" ] }, { "row_data": [ "70-80", "XL", "XL", "XXL" ] }, { "row_data": [ "80-90", "XXL", "XXL", "XXL" ] } ] }, "table_content": null }, { "text": null, "title": null, "type": "TAB", "url": null, "cross_table_content": null, "table_content": null, "tabs": [ { "tab_content": [ { "table_content": null, "tabs": [ { "tab_content": [ { "cross_table_content": null, "table_content": { "unit": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" }, "country_size": null, "remark": "1inch = 2.54cm", "size_data": [ { "row_data": [ "SIZE", "UNDER BUST", "CUP HEIGHT" ] }, { "row_data": [ "S", "24.4", "5.3" ] }, { "row_data": [ "M", "26", "5.7" ] }, { "row_data": [ "L", "27.6", "6.2" ] } ] }, "text": null, "title": "Size Chart", "type": "SIZE_CHART", "url": null }, { "url": null, "cross_table_content": null, "table_content": null, "text": "

Sizes can vary from 2-3 centimeters because they are measured by hand. 

", "title": null, "type": "TEXT" } ], "tab_name": "TOP" }, { "tab_content": [ { "type": "SIZE_CHART", "url": null, "cross_table_content": null, "table_content": { "size_data": [ { "row_data": [ "SIZE", "bottom length\t", "bottom waist" ] }, { "row_data": [ "S", "31.7-8.7", "22.0" ] }, { "row_data": [ "M", "32.1-9.1", "23.6" ] }, { "row_data": [ "L", "32.5-9.4", "25.2" ] } ], "unit": { "convert_unit": "in", "default_unit": "cm", "unit_type": "LENGTH" }, "country_size": null, "remark": "1inch = 2.54cm" }, "text": null, "title": "Size Chart" }, { "table_content": null, "text": "

Sizes can vary from 2-3 centimeters because they are measured by hand. 

", "title": null, "type": "TEXT", "url": null, "cross_table_content": null } ], "tab_name": "BOTTOM" } ], "text": null, "title": null, "type": "TAB", "url": null, "cross_table_content": null } ], "tab_name": "Product Measurements" }, { "tab_name": "Body Measurements", "tab_content": [ { "title": null, "type": "IMAGE", "url": "https://d2n979dmt31clo.cloudfront.net/image/rule/1709518999861/dce7fffb9108427a854708b7379d8346.png?w=1740&h=1317", "cross_table_content": null, "table_content": null, "tabs": null, "text": null } ] } ] } ], "language_scope": "SPECIFIC", "size_chart_id": "13268300202703737403692275", "applicable_attribute_list": [ "size" ], "applicable_product_type": "SPECIFIC", "title": "sizechart_en", "product_list": [ "16067821420558192659742275" ] } } } } } }, "required": true }, "responses": { "200": { "description": "更多状态码信息，参考 [HTTP 状态码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/http-status-code.md?lang=zh-hans-cn)。", "headers": { "traceId": { "description": "请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "name": "data", "description": "响应数据。", "type": "object", "properties": { "size_chart_id": { "name": "size_chart_id", "description": "尺码表 ID。", "type": "string", "example": "13266288837293171311580520" } }, "example": { "size_chart_id": "13266288837293171311580520" } } }, "example": { "data": { "size_chart_id": "13266288837293171311580520" } } }, "examples": { "更新尺码表": { "description": "更新尺码表，商品将优先使用最新更新的尺码数据进行展示。", "value": { "data": { "size_chart_id": "13268300202703737403692275" } } } } } } }, "401": { "headers": { "traceId": { "description": "请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "errors": { "description": "错误描述。", "type": "string" } }, "required": [ "errors" ] } } } }, "429": { "headers": { "traceId": { "description": "请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "errors": { "description": "错误描述。", "type": "string" } }, "required": [ "errors" ] } } } } }, "security": [ { "oauth2": [] } ], "method": "put", "path": "/sizechart.json", "servers": [ { "url": "https://{handle}.myshopline.com/admin/openapi", "variables": { "handle": { "default": "openapiceshidianpu", "description": "`handle` ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 `open001.myshopline.com` 的店铺，其 `handle` 是 `open001` 。" } } } ], "info": { "title": "更新尺码", "version": "v20270301" }, "authIndexes": [ "write_product_sizechart" ] } ```