主题

主题控制Shopify在线商店的外观。

主题 - 图1

一个商店最多可以有20个主题,其中一个就是客户访问在线商店时看到的已发布主题。客户看不到未发布的主题。发布主题时,以前发布的主题将变为未发布。

要在主题上载后修改文件,请使用Asset资源。要了解如何创建自己的主题,请参阅构建主题

您可以用主题做什么

Shopify API使您可以使用主题资源执行以下操作。这些常规操作的更详细的版本可能可用:

主题属性

created_at 只读 plain "created_at": "2012-08-24T14:01:47-04:00" 创建主题的日期和时间(ISO 8601格式)。
ID 只读 plain "id": 828155753 主题的唯一数字标识符。
姓名 plain "name": "Comfort" 主题名称。
可预览 只读 plain "previewable": true 当前是否可以预览主题。
加工 只读 plain "processing": true 该主题是否仍在复制文件中。
角色 plain "role": "main" 指定在商店中如何使用主题。有效值:
+ main:主题已发布。客户在访问在线商店时会看到它。
+ 未发布:主题未发布。客户看不到它。
+ demo:主题作为演示安装在商店中。在商家购买完整版本之前,无法发布该主题。
theme_store_id 只读 plain "theme_store_id": 775 唯一标识符,应用于从Shopify主题商店主题商店安装的Shopify制作的主题。并非主题商店中可用的所有主题都是Shopify开发的。返回null如果商店的主题不是由Shopify发,或者如果它没有从主题商店安装。
Updated_at 只读 plain "updated_at": "2012-08-24T14:01:47-04:00" 上次更新主题的日期和时间(ISO 8601格式)。

终点

得到/admin/api/2021-01/themes.json 检索主题列表。
领域 仅显示某些字段,这些字段由逗号分隔的字段名称列表指定。

检索主题列表

GET /admin/api/2021-01/themes.json

查看回应

得到/admin/api/2021-01/themes/{theme_id}.json 检索单个主题。
领域 仅显示某些字段,这些字段由逗号分隔的字段名称列表指定。

检索单个主题

GET /admin/api/2021-01/themes/828155753.json

查看回应

邮政/admin/api/2021-01/themes.json 通过提供包含主题的ZIP文件的公共URL来创建主题。

默认情况下,始终不会发布新主题。要在创建主题时发布主题,请 "role": "main"在POST请求中添加主题。仅在Shopify提取并存储了所有文件之后,该主题才会发布,这可能需要几分钟。

创建一个具有自定义名称并发布的主题

POST /admin/api/2021-01/themes.json

{

“主题” : {

  1. “名称” :“柠檬草”,
  2. src :“ [http://themes.shopify.com/theme.zip](http://themes.shopify.com/theme.zip)”,
  3. “角色” :“主要”

}

}

查看回应

创建没有名称的主题失败并返回错误

POST /admin/api/2021-01/themes.json

{

“主题” : {

  1. body :“ foobar

}

}

查看回应

/admin/api/2021-01/themes/{theme_id}.json 更新现有主题。

更新主题名称

PUT /admin/api/2021-01/themes/752253240.json

{

“主题” : {

  1. id 752253240
  2. “名称” :“实验性”

}

}

查看回应

发布未发布的主题

PUT /admin/api/2021-01/themes/752253240.json

{

“主题” : {

  1. id 752253240
  2. “角色” :“主要”

}

}

查看回应

删除/admin/api/2021-01/themes/{theme_id}.json 删除主题。

删除主题

删除/admin/api/2021-01/themes/752253240.json

查看回应