检索 YouTube 及合作伙伴订单项

您可以使用 Display & Video 360 API 检索 YouTube 及合作伙伴订单项、其广告组和广告资源，以及与 YouTube 及合作伙伴广告投放相关的定位条件。YouTube 及合作伙伴资源和定位条件只能 通过界面创建或更新。

本页介绍了如何使用 Display & Video 360 API 来识别 YouTube 及合作伙伴资源并检索相关定位条件，以及如何使用界面中的结构化数据文件 (SDF) 批量创建和更新 YouTube 及合作伙伴资源。

确定 YouTube 及合作伙伴资源

YouTube 及合作伙伴资源由某些类型的订单项、广告组和广告组成。

以下 LineItemType 值的订单项是 YouTube 及合作伙伴订单项，无法创建或更新：

您可以从 LineItem 资源的 youtubeAndPartnersSettings 字段中检索 YouTube 及合作伙伴订单项的专属设置。

YouTube 广告组和广告是 YouTube 及合作伙伴订单项下的子资源，方便您进一步指定。

一个 YouTube 及合作伙伴订单项下可以有多个 AdGroup 资源，每个资源都有自己的其他定位条件和出价策略。每个 AdGroup 资源下可以包含多个具有相同广告格式的 AdGroupAd 资源，每个资源都有自己的广告素材信息和其他跟踪网址列表。

用于投放 YouTube 及合作伙伴广告的定位条件是在广告客户级、订单项级和广告组级指定的。

根据非 YouTube 及合作伙伴资源的标准，从父级资源继承的 YouTube 及合作伙伴定位条件不会反映在子资源的定位设置中。

为了检索与 YouTube 及合作伙伴广告投放相关的所有定位条件，您必须执行以下操作：

使用 advertisers.listAssignedTargetingOptions 检索分配给其父级广告客户的定位条件，
使用 advertisers.lineItems.bulkListAssignedTargetingOptions 获取分配给其父订单项的定位条件，
并使用 advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions 检索分配给其父广告组的定位条件。

与 YouTube 及合作伙伴资源一样，您无法修改 使用 Display & Video 360 API 的 YouTube 及合作伙伴定位条件。如果尝试修改以下定位条件，系统将返回错误：

在任意层级分配的以下定位类型：TARGETING_TYPE_SESSION_POSITION、TARGETING_TYPE_YOUTUBE_CHANNEL 和 TARGETING_TYPE_YOUTUBE_VIDEO。
向 YouTube 及合作伙伴订单项资源分配的定位条件。
已为“AdGroup”资源分配定位条件。

虽然您无法使用 Display & Video 360 API 创建或更新 YouTube 及合作伙伴资源，但您可以使用通过 Display & Video 360 界面上传结构化数据文件 (SDF)，批量创建或更新 YouTube 及合作伙伴订单项、广告组和广告。

这些资源通过订单项、YouTube 广告组和 YouTube 广告文件格式显示在 SDF 中。

您可以使用 Display & Video 360 API 生成和下载结构化数据文件。修改现有行以更改现有资源，或添加新行以创建新资源，并通过 Display & Video 360 界面上传更新后的文件。