产品

在选定上下文中读取、创建、更新和删除目录产品。

操作

获取列表 — 产品读取“产品”的数据。结果取决于此操作的参数。 GET 获取 — 产品查看产品列表和产品详细信息。 GET 创建 — 产品将新产品添加到目录中。 POST 更新 — 产品更改现有产品、价格和出版物数据。 PATCH 删除 — 产品从管理面板、店铺和搜索中移除商品，同时保留历史交易数据。 DELETE 产品 · 添加文件 · upload_id创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers. POST 产品 · 状态 · upload_id创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers. GET 产品 · 添加文件 · multipart创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers. PUT 产品 · 商品文件创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers. GET 产品 · 添加文件 · product_id创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers. POST 产品 · 下载 · 文件创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers. GET 产品 · 请求头与响应头创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers. HEAD 产品 · 添加文件 · 版本创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers. POST 产品 · 移除 · 文件创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers. DELETE 产品 · 数字版本创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers. GET 产品 · 添加文件 · 草稿此操作已停用，返回409且不会修改数据。请通过接收对象选择，为每个数字文件单独设置访问权限。 POST 产品 · 请求 · 草稿此操作已停用，返回409且不会修改数据。请通过接收对象选择，为每个数字文件单独设置访问权限。 PATCH 产品 · 移除 · 草稿此操作已停用，返回409且不会修改数据。请通过接收对象选择，为每个数字文件单独设置访问权限。 DELETE 产品 · 发布版本此操作已停用，返回409且不会修改数据。请通过接收对象选择，为每个数字文件单独设置访问权限。 POST 产品 · 撤回销售此操作已停用，返回409且不会修改数据。请通过接收对象选择，为每个数字文件单独设置访问权限。 POST 产品 · 购买后对未来文件的访问权限此操作已停用，返回409且不会修改数据。请通过接收对象选择，为每个数字文件单独设置访问权限。 PATCH 读取文件接收对象读取访问规则和商品版本。首次发布时间保持不变。 GET 选择文件接收对象选择符合条件的购买。所选订单必须包含已付款且未退款的此商品。 PATCH

工作原理

集成可以读取所有未删除的产品，包括草稿，但不包括被套餐限制阻止的产品。被阻止的产品不出现在列表中；直接访问返回 entitlements.resource_blocked。因此，产品在 API 中的可见性不同于店面发布状态。

使用品牌、分类、属性和媒体的现有标识符。价格包含明确的币种、价格表、税务模式和并发控制版本。产品定价与变体定价相互独立；请使用支持的价格结构及精确的十进制字符串。

商品文件

创建 upload_id 后，以 multipart/form-data 上传文件，再关联到商品。下载需要 Bearer 令牌及 category 对应权限；响应直接包含文件字节，不使用公开地址或密码。共享销售文件的明确访问规则。 new_purchases / recent_and_new / selected / all_purchasers.

请选择有效的 PDF、ZIP、EPUB、MP3 或 MP4, WebP, PNG, JPG, SVG, AVIF 文件。每个文件最大 250 MiB. 每件商品最多可有 20 个有效文件。