结构化数据文件 (SDF) 是采用特殊格式的 CSV 文件。它们支持在 Display & Video 360 中批量检索、创建和修改资源。通过下载、修改和重新上传 SDF，批量更新资源。
Display & Video 360 界面支持 SDF 下载和上传。Display & Video 360 API 支持下载结构化数据文件。
表现形式
SDF 使用两种基本格式之一，即标准和质量保证：
- 您可以下载和上传标准格式的文件。这些文件中的数据可能会使用数字 ID，以确保上传时的准确性。可能需要参考信息才能解读数据。
- 您可以下载 QA 格式的文件。这些文件提供的数据与标准格式文件相同，但使用更易于理解的值。例如，某些列可能会使用显示名称代替 ID。此格式特有的列使用后缀“Qa”。
文件类型
SDF 支持七种资源类型。每种资源类型都有自己的文件类型和列结构。支持的资源类型包括：
- 广告系列
- 广告订单
- 订单项
- 广告组
- 广告
- 广告资源来源
- 媒体产品
只有订单项和广告组文件类型支持 QA 格式。
我们会定期发布新的 SDF 版本，并弃用旧版本。新版本会更新文件类型列结构。如有必要，新版 SDF 将在发布时附带迁移指南。
下载错误
SDF 下载可能会导致两种类型的错误：文件生成错误和跳过的资源。
文件生成错误
SDF 生成可能会因错误而终止。如果使用 Display & Video 360 API 时生成失败，已完成的任务会使用 Status 对象设置其 error 字段。Status 对象将包含一条详细说明错误原因的消息。
如需详细了解这些错误，请参阅我们的“错误和警告”指南页面。
跳过的错误
SDF 不支持所有资源子类型。如果某个资源无法包含在 SDF 中，下载内容中会包含一个“已跳过”文件（例如：SDF-LineItems-Skipped.csv）。此文件采用双列结构。第一列用于标识跳过的资源。第二列说明了排除原因。
上传文件
使用 Display & Video 360 界面上传 SDF，以创建新资源或更新现有资源。
请按照以下步骤操作，以最大限度地减少在使用 SDF 更新或创建资源时出现的错误：
- 使用 Display & Video 360 API 或界面下载 SDF。
- 修改现有文件条目以更新现有资源。
- 添加文件条目以创建新资源。
- 移除所有不是新条目或更新条目的条目。这样可以减小文件大小，并避免出现意外更新。
- 在 Display & Video 360 界面中上传文件。
上传并处理 SDF 后，即可下载 SDF-ResultFile.zip 文件。此 ZIP 文件可能包含以下两种文件：
SDF-{ResourceType}-Updated-ResultFile.csv，其中列出了成功更新或创建的资源。SDF-{ResourceType}-Failed-ResultFile.csv，其中列出了失败的操作和相关错误消息。
ZIP 文件可能包含一个或两个文件。