资产

主题资产是组成商店主题的单个文件。

资产 - 图1

主题的资产包括其模板,图像,样式表和额外的代码段。它们安排在主题的目录之间,例如layouttemplateasset。您可以使用资产资源从商店的主题中添加,更改或删除资产文件。有关主题目录的完整列表,请参见主题结构

要了解如何创建自己的主题,请参阅构建主题

您可以使用资产做什么

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

资产属性

依恋 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请求中,您可以包括srcsource_key属性,以根据现有文件创建资产。

src 图像的源URL。包含在PUT请求的主体中,以将图像上传到Shopify。
source_key 主题内到现有资产的路径。包括在PUT请求的主体中以创建重复资产。

更改现有Liquid模板的值

PUT /admin/api/2021-01/themes/828155753/assets.json

{

“资产” : {

  1. “键” :“模板/ index.liquid”,
  2. value :“ <img src ='backsoon-postit.png'> <p>我们正忙于为您更新商店,一小时之内就会回来。</ p>”

}

}

查看回应

通过提供base64编码的附件来创建图像资产

PUT /admin/api/2021-01/themes/828155753/assets.json

{

“资产” : {

  1. key :“ assets / empty.gif”,
  2. 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”: {

  1. "key": "assets/bg-body.gif",
  2. "src": "http://apple.com/new_bg.gif"

}

}

View Response

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"

}

}

View Response

删除/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

查看回应