版本：202601

主题

管理店铺主题：查询、安装、发布与维护主题

主题用于控制店铺前台的视觉布局与模板，由布局、模板、区块、片段、资产、配置和语言环境文件组成。

提供查询主题列表与详情、删除主题、查询默认主题，重命名、复制、发布、升级主题，浏览主题市场并安装主题，以及查询后台任务等接口。读写主题文件见「主题文件」；通过编辑会话编辑主题见「主题会话」。

📄️查询主题列表

返回店铺的主题列表，可按 `published`、`ids` 过滤。

通过主题 ID 获取指定主题的详情。

通过主题 ID 删除指定主题。默认主题不能删除。

获取店铺默认主题的详情。

修改当前店铺中指定主题的显示名称。

在当前店铺内把已有主题复制为一个新主题，返回新主题 ID；可用 `sources` 限定复制范围。

将指定主题发布为当前使用主题。

基于指定主题生成一个升级到最新版本的新主题，并沿用原主题的配置，原主题保持不变；返回新主题 ID。

返回主题市场中可安装的平台主题。支持按价格档、行业、语言、分类和特性过滤。

按市场主题 id 把主题安装到当前店铺。支持指定主题名称与样式预设，并可设为店铺默认主题；店铺还没有默认主题时，安装的主题会自动设为默认主题。

获取主题上传、升级等后台任务的状态和详情。