更新店铺翻译语料
PUT https://{handle}.myshopline.com/admin/openapi/v20260901/ugc/resource.json
handle :店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com 的店铺,其 handle 是 open001 。更新店铺的翻译语料。你可以使用该接口基于指定市场 ID(market)、语言(locale)、资源 ID(resource_id)、资源类型(resource_type)对应的翻译语料内容(resource_content) 和资源对应的类型细分(resource_field) 进行更新。
请求头
- Content-Type string required字段值固定为
application/json; charset=utf-8。 - Authorization string required资源的访问令牌。参考 应用授权 获取访问令牌,然后将获取到的访问令牌以 Bearer 格式传入。例子:
Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA
请求体
resource_listobject[] required
待更新的资源对象列表。
最大个数限制:200。content_listobject[] required
资源对应的翻译语料列表。
最大个数限制:100。resource_content string required资源对应的翻译语料内容。例子:The content of the key to the key of the cotresource_field string requiredresource_content所关联的资源属性。例如,当resource_type为PRODUCT且resource_field为title时,resource_content为商品标题。该字段枚举值范围取决于resource_type。resource_field与resource_type的枚举值及对应关系参考 resource_type 和 resource_field。例子:titlemarket string商店的主要市场。例子:2805652120189036673434resource_id string required资源对象 ID。
样例:当resource_type为PRODUCT,代表商品 ID。例子:16065157700911371584482600resource_type string required资源的类型。有效枚举值包含:COLLECTION:商品分类PRODUCT:商品PRODUCT_Category:商品标准类型PRODUCT_OPTION:商品规格PRODUCT_VARIANT:商品款式SELLING_PLAN:销售计划FILTER:选项FILTER_GROUP:选项组FILTER_VALUE:选项值SORT:排序DELIVERY_METHOD:物流方式PAYMENT_METHOD:支付方式TAXES:税费SETTLE_CONFIG:结账配置SETTLE_ADDITIONAL_INFO:结账配置附加信息WEBSITE_BLOG:博客WEBSITE_BLOG_COLLECTION:博客集合WEBSITE_CUSTOMIZE_PAGE:自定义页面WEBSITE_NAVIGATION:菜单导航WEBSITE_POLICY_PAGE:政策LINK:菜单项METAFIELD:元字段
例子:COLLECTION
状态码
- 200
- 401
- 429
更多状态码信息,参考 HTTP 状态码。
响应头
traceId
请求的全局唯一标识符 。用于追踪请求在系统中的流转,以便于问题发生时进行定位和调试。
响应体
dataobject
响应结果。fail_listobject[]
商店语料数据的更新失败列表。market string商店的主要市场。例子:2805652120189036673434resource_content string资源对应的翻译语料内容。例子:The content of the key to the key of the cotresource_field stringresource_content所关联的资源属性。例如,当resource_type为PRODUCT且resource_field为title时,resource_content为商品标题。该字段枚举值范围取决于resource_type。resource_field与resource_type的枚举值及对应关系参考 resource_type 和 resource_field。例子:titleresource_id string资源对象 ID。
样例:当resource_type为PRODUCT,代表商品 ID。resource_type string资源的类型。有效枚举值包含 :COLLECTION:商品分类PRODUCT:商品PRODUCT_Category:商品标准类型PRODUCT_OPTION:商品规格PRODUCT_VARIANT:商品款式SELLING_PLAN:销售计划FILTER:选项FILTER_GROUP:选项组FILTER_VALUE:选项值SORT:排序DELIVERY_METHOD:物流方式PAYMENT_METHOD:支付方式TAXES:税费SETTLE_CONFIG:结账配置SETTLE_ADDITIONAL_INFO:结账配置附加信息WEBSITE_BLOG:博客WEBSITE_BLOG_COLLECTION:博客集合WEBSITE_CUSTOMIZE_PAGE:自定义页面WEBSITE_NAVIGATION:菜单导航WEBSITE_POLICY_PAGE:政策LINK:菜单项METAFIELD:元字段
例子:COLLECTIONfail_cause string更新失败原因。例子:VERIFY_RESOURCE_FAILresource_listobject[]
更新的资源集合列表。resource_type string资源的类型。有效枚举值包含:COLLECTION:商品分类PRODUCT:商品PRODUCT_Category:商品标准类型PRODUCT_OPTION:商品规格PRODUCT_VARIANT:商品款式SELLING_PLAN:销售计划FILTER:选项FILTER_GROUP:选项组FILTER_VALUE:选项值SORT:排序DELIVERY_METHOD:物流方式PAYMENT_METHOD:支付方式TAXES:税费SETTLE_CONFIG:结账配置SETTLE_ADDITIONAL_INFO:结账配置附加信息WEBSITE_BLOG:博客WEBSITE_BLOG_COLLECTION:博客集合WEBSITE_CUSTOMIZE_PAGE:自定义页面WEBSITE_NAVIGATION:菜单导航WEBSITE_POLICY_PAGE:政策LINK:菜单项METAFIELD:元字段
例子:COLLECTIONmarket string商店的主要市场。例子:2805652120189036673434outdated boolean查询过时或最新的翻译数据。如果原始内容已更新但翻译尚未更新,则翻译将被标记为“过时”。true: 查询过时的翻译数据。false: 查询最新的翻译数据。
resource_content string资源对应的翻译语料内容。例子:The content of the key to the key of the cotresource_field stringresource_content所关联的资源属性。例如,当resource_type为PRODUCT且resource_field为title时,resource_content为商品标题。该字段枚举值范围取决于resource_type。resource_field与resource_type的枚举值及对应关系参考 resource_type 和 resource_field。例子:titleresource_id string资源对象 ID。
样例:当resource_type为PRODUCT,代表商品 ID。
API Explorer
调试台
示例代码
这篇文章对你有帮助吗?