Yandex Market中的YML 文件是什么意思？有什么用？

在跨境电商与大规模商品管理中，如何高效更新和维护商品目录，是影响店铺运营效率的关键因素之一。Yandex Market 提供的 YML（Yandex Market Language）文件，能够帮助商家以标准化方式批量管理商品数据和上架流程。本篇文章将系统介绍 YML 文件的结构与必需元素，帮助您快速理解和应用这一工具。

什么是 YML 文件？

YML（Yandex Market Language）是 Yandex 基于 XML（可扩展标记语言）制定的自有标准。YML 文件可以便于商家使用自动生成的格式，完整描述商店的目录。

本指南描述了 YML 文件的所有必要元素。

建议

如果您使用常见的 CMS（内容管理系统），通常会有现成模块用于生成 YML 文件，您可以在现成模块列表2 中查看支持的系统。

YML 文件的用途

使用 YML 文件可以完成两个任务：

将商品添加到目录并更新其信息；

管理商品在商店中的放置。

解决不同任务的 YML 文件在必需元素集上有所不同。

YML 文件的必需元素有哪些

文件头部（Header）

任何 YML 文件都必须包含文件头部。写法如下：

文件头必须位于第一行，并从第一个字符开始。

支持UTF-8和Windows-1251编码。

根元素 <yml_catalog>

所有 YML 文件都必须包含根元素：<yml_catalog>，并带有 date 属性。

属性中需指定文件数据生效的日期和时间，上传版本不应超过 10 天，且必须符合 RFC 3339 标准，如下所示：

必须指定时区，时区从 UTC 开始计算。例如克拉斯诺亚尔斯克时间：

请注意，您不能指定未来的日期和时间。如果文件生成耗时较长，请在属性中填写生成开始时间。

重要提醒

如果您通过 YML 传递库存或价格，则必须指定 date 属性。

元素<shop>

是 YML 文件中描述商店的核心部分，必须唯一且无属性，包含在 <yml_catalog内。

它包含以下嵌套元素：

元素<categories>

建议

如果从 Yandex Market 的列表3 中选择类别值，商品将立即归入相应类别。如果使用商店自定义类别列表，则平台会自动确定商品的分类。

此元素仅用于管理商品的 YML 文件中。

嵌套在元素内，没有属性，且应放置在元素之前。它可以包含任意数量的元素，每个元素描述商店中可用的一个商品类别。

创建类别时请遵循以下建议：

指定具体类别：例如，一套刀具最好归类到“餐具”类别，而不是笼统的“器皿”。

选择描述商品的类别，而不是抽象特征：例如，最好指定“香水”而非“礼物”。

每个类别必须分配一个唯一标识符，该标识符应为最多 18 位的正整数，并在 id 属性中记录。数字不能以零开头，例如 055 不合适。

若需将一个类别嵌套到另一个类别中，请使用 parentId 属性。

示例如下：

元素<offers>

所有 YML 文件都必须包含元素。嵌套元素的内容取决于 YML 文件要解决的任务。

放置在元素之后，无属性。每个描述商店中的一个商品，并必须具有 id 属性，用于指定商品 SKU。

关于商品 SKU

重要提醒

元素已过时，不建议您继续使用。如果文件中仍存在该元素，您的 SKU 值将从中获取，而不是从元素的 id 属性中获取。

在内部需要指定商品特性（名称、描述、制造商等）或放置参数（价格、折扣、库存等）。