您可以使用 Display & Video 360 API 检索 YouTube 及合作伙伴订单项、其广告组和广告资源，以及与 YouTube 及合作伙伴广告投放相关的定位条件。YouTube 及合作伙伴资源和定位条件只能通过界面创建或更新。
本页介绍了如何使用 Display & Video 360 API 识别 YouTube 及合作伙伴资源并检索相关定位条件，以及如何在界面中使用结构化数据文件 (SDF) 批量创建和更新 YouTube 及合作伙伴资源。
确定 YouTube 及合作伙伴资源
YouTube 及合作伙伴资源包括特定类型的订单项、广告组和广告。
订单项
以下 LineItemType 值的订单项属于 YouTube 及合作伙伴订单项，无法创建或更新：
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTIONLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIOLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACHLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLELINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOPLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCYLINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
您可以从 LineItem 资源的 youtubeAndPartnersSettings 字段检索特定于 YouTube 及合作伙伴订单项的设置。
YouTube 广告组和广告
YouTube 广告组和广告是“YouTube 及合作伙伴”订单项下的子资源，可供进一步指定。
YouTube 及合作伙伴订单项下可以包含多个 AdGroup 资源，每个资源都有自己的附加定位条件和出价策略。每个 AdGroup 资源下可以有多个AdGroupAd资源，这些资源采用相同的广告格式，每个资源都有自己的广告素材信息和额外跟踪网址列表。
检索定位条件
用于投放 YouTube 及合作伙伴广告的定位条件可在广告客户级、订单项级和广告组级分配。
从父级资源继承的 YouTube 及合作伙伴定位条件不会反映在子资源的定位设置中，这与非 YouTube 及合作伙伴资源的标准相同。
如需检索与投放 YouTube 及合作伙伴广告相关的所有定位条件，您必须满足以下条件：
- 使用
advertisers.listAssignedTargetingOptions检索分配给其父级广告客户的定位条件， - 使用
advertisers.lineItems.bulkListAssignedTargetingOptions检索分配给其父级订单项的定位条件， - 并使用
advertisers.adGroups.bulkListAssignedTargetingOptions检索分配给其父级广告组的定位条件。
尝试修改 YouTube 定位条件
与 YouTube 及合作伙伴资源一样，您无法使用 Display & Video 360 API 修改 YouTube 及合作伙伴定位条件。如果您尝试修改以下定位条件，系统会返回错误：
- 在以下定位类型的任一级别分配的定位条件：
TARGETING_TYPE_SESSION_POSITION、TARGETING_TYPE_YOUTUBE_CHANNEL和TARGETING_TYPE_YOUTUBE_VIDEO。 - 分配给 YouTube 及合作伙伴订单项资源的定位条件。
- 分配给
AdGroup资源的定位条件。
使用 SDF 界面上传功能创建和更新
虽然您无法使用 Display & Video 360 API 创建或更新 YouTube 及合作伙伴资源，但可以使用通过 Display & Video 360 界面上传结构化数据文件 (SDF) 批量创建或更新 YouTube 及合作伙伴订单项、广告组和广告。
这些资源在 SDF 中通过订单项、YouTube 广告组和 YouTube 广告文件格式表示。
您可以使用 Display & Video 360 API 生成和下载结构化数据文件。修改现有行以更改现有资源，或添加新行以创建新资源，然后通过 Display & Video 360 界面上传更新后的文件。