一件可定制商品可能需要文字,也可能需要选项或文件。Etsy Open API v3的Personalization Migration Guide说,原单一自由文本字段已由支持多个、有类型输入的结构取代。[1] 本篇读的是这份开发文档的对象定义,不据此确认某间店铺已经采用新功能。
What changed部分写,每个出品支持至多五个定制问题,问题类别为文本输入、下拉选择和文件上传。五是可出现的问题数量上限,三是类别数量;不能据此改写成每件商品必须恰有三问,或者每类必须填一问。多个问题与多种类别,是文档同时保留的两个维度。
结构示例的question_type却列四个值:text_input、dropdown、unlabeled_upload和labeled_upload。多出的一个并不表示导语突然多了一类完全不同的商品需求,而是上传在类型值中分为有标签和无标签两种。把三个问题类别与四个具体值连读,才能避免仅数字符串就宣称前后矛盾。
每种类型还有自己的适用字段。示例将max_allowed_characters联系到文本输入,max_allowed_files联系到上传,options联系到下拉及有标签上传。它们分别描述字符数、文件数或选项,不是看到同一段结构就应给每种问题都补齐全部字段。这里解释的是数据内容关系,没有给出配置数值、写入请求或文件操作。
出品上的问题与成交后的回答也有不同位置。Reading transaction personalization data说,相关数据如有,会在交易对象的variations数组中返回;formatted_name可以是卖家设置的名称,不一定固定为Personalization,property_id为54的对象也可能有多个。由此,读取到一个旧标签不能独自承担识别所有回答的任务,多个回答也不必被缩成一条自由文本。
这份说明对平台商品资料的价值,是把“询问什么”“属于哪种输入”与“交易保存了哪些回答”分别表达。一句“支持定制”还没有说明问题数量、类型或具体回答;某交易存在多个同类对象,也不能反推它们必有相同名称。本文只分析文档结构,没有查阅任何真实买家内容或还原个人文件。
来源限定当前实际读到的Etsy Open API v3指南,精确首发和上线日未确认,页脚2021不当本文日期。写入、删除、参数迁移、权限和附加价格不在采用范围;帮助中心受限页面也未作为正文依据。本篇不提供接口操作、卖家资格或合同效果判断,只解释由单字段展开的问题与回答关系。
信息来源
本文基于上述公开资料整理,未使用来源页面的图片、视频或嵌入媒体。