资产
主题资产是组成商店主题的单个文件。
主题的资产包括其模板,图像,样式表和额外的代码段。它们安排在主题的目录之间,例如layout,template和asset。您可以使用资产资源从商店的主题中添加,更改或删除资产文件。有关主题目录的完整列表,请参见主题结构。
要了解如何创建自己的主题,请参阅构建主题。
您可以使用资产做什么
Shopify API使您可以对Asset资源执行以下操作。这些常规操作的更详细的版本可能可用:
- GET /admin/api/2021-01/themes/{theme_id}/assets.json检索主题的资产列表
- GET /admin/api/2021-01/themes/{theme_id}/assets.json?asset[key]=templates/index.liquid检索主题的单个资产
- PUT /admin/api/2021-01/themes/{theme_id}/assets.json创建或更新主题的资产
- 删除/admin/api/2021-01/themes/{theme_id}/assets.json?asset[key]=layout/theme.liquid从主题中删除资产
资产属性
依恋 | plain "attachment": "R0lGODlhAQABAPABAP///wAAACH5Ow==\n" base64编码的图像。 |
---|---|
校验和 只读 | plain "checksum": "f69db2c563b5be32648ac7367557c09c" 内容的MD5表示形式,由32个十六进制数字的字符串组成。如果资产最近未更新,则可能为null。 |
内容类型 只读 | plain "content_type": "image/gif" 内容的MIME表示形式,由资产的类型和子类型组成。 |
created_at 只读 | plain "created_at": "2010-07-12T15:31:50-04:00" 创建资产的日期和时间(ISO 8601格式)。 |
钥匙 | plain "key": "assets/bg-body-green.gif" 主题中资产的路径。它由文件的目录和文件名组成。例如,资产assets/bg-body-green.gif 位于资产目录中,因此其键为assets/bg-body-green.gif 。 |
public_url 只读 | plain "public_url": "http://static.shopify.com/assets/bg.gif?1" 资产的面向公众的URL。 |
尺寸 只读 | plain "size": 1542 资产大小(以字节为单位)。 |
theme_id 只读 | plain "theme_id": 828155753 资产所属主题的ID。 |
Updated_at 只读 | plain "updated_at": "2010-07-12T15:31:50-04:00" 资产上次更新的日期和时间(ISO 8601格式)。 |
价值 | plain "value": "<div id=\"page\">\n<h1>404 Page not found</h1>\n<p>We couldn't find the page you were looking for.</p>\n</div>" 资产的文本内容,例如模板文件的HTML和Liquid标记。 |
终点
得到/admin/api/2021-01/themes/{theme_id}/assets.json 检索主题的资产列表。列出主题资产仅返回有关每个资产的元数据。要获取资产的内容,您需要单独检索资产。领域 | 只显示由逗号分隔的字段名称列表指定的某些字段 |
---|---|
检索主题的所有资产的列表
GET /admin/api/2021-01/themes/828155753/assets.json
得到/admin/api/2021-01/themes/{theme_id}/assets.json?asset[key]=templates/index.liquid通过其关键字检索主题的单个资产。
要检索单个资产,请包含asset[key]=#{asset_key}
作为请求参数。例如,要检索键为的资产templates/index.liquid
,请求可能为/admin/themes/828155753/assets.json?asset[key]=templates/index.liquid
。
有关该key
属性的更多信息,请参见资产属性。
领域 | 只显示由逗号分隔的字段名称列表指定的某些字段 |
---|---|
检索液体模板
GET /admin/api/2021-01/themes/828155753/assets.json?asset[key]=templates/index.liquid
放/admin/api/2021-01/themes/{theme_id}/assets.json创建或更新主题的资产。
在PUT请求中,您可以包括src
或source_key
属性,以根据现有文件创建资产。
src | 图像的源URL。包含在PUT请求的主体中,以将图像上传到Shopify。 |
---|---|
source_key | 主题内到现有资产的路径。包括在PUT请求的主体中以创建重复资产。 |
更改现有Liquid模板的值
PUT /admin/api/2021-01/themes/828155753/assets.json
{
“资产” : {
“键” :“模板/ index.liquid”,
“ value” :“ <img src ='backsoon-postit.png'> <p>我们正忙于为您更新商店,一小时之内就会回来。</ p>”
}
}
通过提供base64编码的附件来创建图像资产
PUT /admin/api/2021-01/themes/828155753/assets.json
{
“资产” : {
“ key” :“ assets / empty.gif”,
“ attachment” :“ R0lGODlhAQABAPABAP /// wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw == \ n”
}
}
Create an image asset by providing a source URL from which to upload the image
PUT /admin/api/2021-01/themes/828155753/assets.json
{
“asset”: {
"key": "assets/bg-body.gif",
"src": "http://apple.com/new_bg.gif"
}
}
Duplicate an existing asset by providing a source key
PUT /admin/api/2021-01/themes/828155753/assets.json
{
“asset”: {
"key": "layout/alternate.liquid",
"source_key": "layout/theme.liquid"
}
}
删除/admin/api/2021-01/themes/{theme_id}/assets.json?asset[key]=layout/theme.liquid 从主题中删除资产。删除主题所需的资产失败并显示错误
删除/admin/api/2021-01/themes/828155753/assets.json?asset[key]=layout/theme.liquid
从主题删除图像
删除/admin/api/2021-01/themes/828155753/assets.json?asset[key]=assets/bg-body.gif