主题
主题控制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
