Youzan Material

---
name: youzan-material
version: 1.1.37
description: "素材中心图片分组、图片列表和图片详情的原始数据查询；不提供图片上传、素材维护或其他远端数据变更能力，不处理音频、视频、趋势分析或素材推荐。"
---

# 图片素材

使用本 skill 前，确认当前授权范围和店铺上下文。商品、页面和广告需要使用图片字段时，分别配合 `youzan-item` 或 `youzan-feature-page`。

## 查询数量限制

- 列表查询必须显式传入页码和每页数量，不得依赖接口默认分页；每页最多查询 20 条。
- 批量查询每批最多传入 20 个对象或标识；超过 20 个时必须拆分为多个批次依次查询，且每批均不得超过 20 个。

## 支持能力

- 查询素材分组列表，按分组名称或分组标识筛选。
- 按素材标识查询图片详情。
- 查询指定分组内的图片列表。
- 返回图片标识、原图地址、缩略图地址、尺寸和分组等原始字段。
- 说明图片字段在商品图文组件中的对应关系，但不生成或设计素材。

## 字段提示

- 查询参数和返回结果中的字段必须使用中文字段名，不展示接口英文原始字段名。

### 必填信息

- 查询单张或多张图片详情时必须提供图片标识列表，单批不得超过 20 个图片标识。
- 查询指定分组的图片时必须提供素材分组标识。

### 非必填信息

- 图片列表的关键词、排序和状态条件可选；分页参数必须按“查询数量限制”传入。
- 查询分组列表时分组名称可选；分页参数必须按“查询数量限制”传入。

## 使用案例

- 用户说“查素材分组”时查询分组列表；查询指定分组内的图片时必须提供分组标识。
- 用户说“查这几张图片的尺寸和原图地址”时，必须提供图片标识列表，并逐项返回尺寸、原图地址和缩略图地址。
- 用户说“找出某分组里名称包含茶叶的图片”时，使用分组标识、关键词和分页条件组合查询。
- 用户说“上传、删除或移动图片”时，说明本 skill 只支持读取素材信息。

## 边界

- 图片上传、删除、移动、分组维护和其他素材中心远端数据变更不在本入口范围内。
- 音频、视频素材以及素材使用统计不在本入口范围内。
- 商品、微页面和广告的内容设计与业务配置使用对应领域技能。