主题
主题控制Shopify在线商店的外观。
一个商店最多可以有20个主题,其中一个就是客户访问在线商店时看到的已发布主题。客户看不到未发布的主题。发布主题时,以前发布的主题将变为未发布。
要在主题上载后修改文件,请使用Asset资源。要了解如何创建自己的主题,请参阅构建主题
您可以用主题做什么
Shopify API使您可以使用主题资源执行以下操作。这些常规操作的更详细的版本可能可用:
- GET /admin/api/2021-01/themes.json 检索主题列表
- GET /admin/api/2021-01/themes/{theme_id}.json 检索单个主题
- POST /admin/api/2021-01/themes.json 创建一个主题
- PUT /admin/api/2021-01/themes/{theme_id}.json 修改现有主题
- DELETE/admin/api/2021-01/themes/{theme_id}.json 删除现有主题
主题属性
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
{
“主题” : {
“名称” :“柠檬草”,
“ src” :“ [http://themes.shopify.com/theme.zip](http://themes.shopify.com/theme.zip)”,
“角色” :“主要”
}
}
创建没有名称的主题失败并返回错误
POST /admin/api/2021-01/themes.json
{
“主题” : {
“ body” :“ foobar”
}
}
放/admin/api/2021-01/themes/{theme_id}.json 更新现有主题。更新主题名称
PUT /admin/api/2021-01/themes/752253240.json
{
“主题” : {
“ id” :752253240,
“名称” :“实验性”
}
}
发布未发布的主题
PUT /admin/api/2021-01/themes/752253240.json
{
“主题” : {
“ id” :752253240,
“角色” :“主要”
}
}
删除/admin/api/2021-01/themes/{theme_id}.json 删除主题。删除主题
删除/admin/api/2021-01/themes/752253240.json