productByHandle

query
接口访问需要令牌，具体如何获取令牌请参考：身份认证
通过 handle 查找产品
Arguments
handle ● String!non-null
用于识别产品的唯一字符串。该 handle 是根据产品标题生成的，转换为小写，并格式化为用连字符替换空格和特殊字符。如果多个产品具有相同的标题，handle 会自动附加一个数字来区分它们。例如，如果有两个标题为“Clothing”的产品，则它们的句柄将为“clothing”和“clothing-1”。修改产品标题不会更新句柄
Return
collections ● CollectionConnection
包含该产品的分类的列表
More
compareAtPriceRange ● ProductCompareAtPriceRange
以默认商店货币表示的产品原价范围
More
createdAt ● Date!non-null
创建产品时的日期和时间
descriptionHtml ● String
产品的描述，包括 HTML 格式
featuredImage ● Image
产品特色图片
More
featuredMedia ● Media
产品的特色媒体
More
handle ● String!non-null
产品的handle
hasOnlyDefaultVariant ● Boolean!non-null
如果该值为 true，则表示该产品只有一种具有默认选项和值的变体
id ● ID!non-null
产品ID，通用的唯一标识符
images ● ImageConnection
与产品相关的图像
More
inCollection ● Boolean
确定产品是否属于指定分类
isGiftCard ● Boolean!non-null
是否礼品卡商品
media ● MediaConnection
与产品相关的媒体。这可以包括图像、视频
More
mediaCount ● Int!non-null
与产品关联的媒体总数
onlineStorePreviewUrl ● URL
用于预览在线商店的 URL
onlineStoreUrl ● URL
在线商店中产品的 URL。如果未发布到在线商店，则该值为空
options ● [ProductOption]
产品的选项列表
More
priceRange ● ProductPriceRange
产品的价格范围，格式为小数价格
More
productCategory ● ProductCategory
商家指定的产品标准类型
More
productType ● String
商家自定义的一个产品类型
publishedAt ● Date
产品发布到在线商店的日期和时间（采用 ISO 8601 格式）
publishedInContext ● Boolean!non-null
产品是否在给定的条件中对客户可见
resourcePublicationsV2 ● ResourcePublicationV2Connection
已发布或准备发布的资源列表
More
spu ● String
产品的SPU码
status ● ProductStatus!non-null
产品状态
More
subtitle ● String
产品摘要
tags ● [String]
产品标签
title ● String!non-null
产品标题
totalInventory ● Int!non-null
产品的可用库存数量
totalVariants ● Int!non-null
产品变体数量
tracksInventory ● Boolean!non-null
产品是否启用库存跟踪
updatedAt ● Date
产品最后修改的日期和时间
variants ● ProductVariantConnection
产品的变体列表
More
vendor ● String
产品品牌
错误码
关于更多通用错误码说明，参考：状态码和错误码。
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2026 SHOPLINE Limited.