自
2025 年 9 月 8 日起,每个新订单项都需要声明是否会投放欧盟 (EU) 政治广告。Display & Video 360 API 和未提供声明的 SDF 上传操作将会失败。如需详细了解如何更新集成以进行此声明,请参阅我们的
弃用页面。
检索 YouTube 及合作伙伴订单项
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
您可以使用 Display & Video 360 API 检索 YouTube 及合作伙伴订单项、其广告组和广告资源,以及与 YouTube 及合作伙伴广告投放相关的定位条件。YouTube 及合作伙伴资源和定位条件只能通过界面创建或更新。
本页介绍了如何使用 Display & Video 360 API 识别 YouTube 及合作伙伴资源并检索相关定位条件,以及如何在界面中使用结构化数据文件 (SDF) 批量创建和更新 YouTube 及合作伙伴资源。
确定 YouTube 及合作伙伴资源
YouTube 及合作伙伴资源包括特定类型的订单项、广告组和广告。
订单项
以下 LineItemType
值的订单项属于 YouTube 及合作伙伴订单项,无法创建或更新:
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
您可以从 LineItem
资源的 youtubeAndPartnersSettings
字段检索特定于 YouTube 及合作伙伴订单项的设置。
YouTube 广告组和广告
YouTube 广告组和广告是“YouTube 及合作伙伴”订单项下的子资源,可供进一步指定。
YouTube 及合作伙伴订单项下可以包含多个 AdGroup
资源,每个资源都有自己的附加定位条件和出价策略。每个 AdGroup
资源下可以有多个AdGroupAd
资源,这些资源采用相同的广告格式,每个资源都有自己的广告素材信息和额外跟踪网址列表。
检索定位条件
用于投放 YouTube 及合作伙伴广告的定位条件可在广告客户级、订单项级和广告组级分配。
从父级资源继承的 YouTube 及合作伙伴定位条件不会反映在子资源的定位设置中,这与非 YouTube 及合作伙伴资源的标准相同。
如需检索与投放 YouTube 及合作伙伴广告相关的所有定位条件,您必须满足以下条件:
尝试修改 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 界面上传更新后的文件。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eThe Display & Video 360 API can be used to retrieve YouTube & Partners line items, ad groups, ads, and their targeting information.\u003c/p\u003e\n"],["\u003cp\u003eYouTube & Partners resources and targeting cannot be created or updated through the API; they must be managed through the Display & Video 360 UI.\u003c/p\u003e\n"],["\u003cp\u003eTo retrieve all targeting relevant to a YouTube & Partners ad, you need to retrieve targeting from the advertiser, line item, and ad group levels.\u003c/p\u003e\n"],["\u003cp\u003eYou can use Structured Data Files (SDF) to create and update YouTube & Partners resources in bulk through the Display & Video 360 UI.\u003c/p\u003e\n"],["\u003cp\u003eThe Display & Video 360 API can be used to generate and download SDFs for editing and subsequent upload through the UI.\u003c/p\u003e\n"]]],["The Display & Video 360 API allows retrieval of YouTube & Partners line items, ad groups, ads, and their targeting. However, these resources and targeting cannot be created or updated via the API. To identify them, look for specific `LineItemType` values. Retrieval of targeting requires fetching data from the advertiser, line item, and ad group levels. Modifications, including targeting adjustments and creation of these resources, can only be done using Structured Data Files (SDF) uploaded through the Display & Video 360 UI.\n"],null,["# Retrieve YouTube & Partners Line Items\n\nYou can retrieve YouTube \\& Partners line items, their ad groups and ad\nresources, and targeting relevant to YouTube \\& Partners ad serving using\nDisplay \\& Video 360 API. **YouTube \\& Partners resources and targeting can only be created**\n**or updated through the UI**.\n\nThis page describes how to use the Display \\& Video 360 API to identify YouTube \\& Partners\nresources and retrieve relevant targeting, and how to create and update YouTube\n\\& Partners resources in bulk using Structured Data Files (SDF) in the UI.\n\nIdentify YouTube \\& Partners resources\n--------------------------------------\n\nYouTube \\& Partners resources consist of certain types of line items, [Ad\nGroups](/display-video/api/reference/rest/v4/advertisers.adGroups), and [Ads](/display-video/api/reference/rest/v4/advertisers.adGroupAds).\n\n### Line Items\n\nLine items of the following [`LineItemType`](/display-video/api/reference/rest/v4/advertisers.lineItems#LineItemType) values are YouTube \\&\nPartners line items and **cannot be created or updated**:\n\n- `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION`\n- `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO`\n- `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE`\n- `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP`\n- `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH`\n- `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP`\n- `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE`\n- `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP`\n- `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY`\n- `LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE`\n\nSettings specific to YouTube \\& Partners line items can be retrieved from the\n[`youtubeAndPartnersSettings`](/display-video/api/reference/rest/v4/advertisers.lineItems#LineItem.FIELDS.youtube_and_partners_settings) field of the\n[`LineItem`](/display-video/api/reference/rest/v4/advertisers.lineItems#LineItem) resource.\n\n### YouTube Ad Groups and Ads\n\nYouTube Ad Groups and Ads are child resources under YouTube \\& Partner\nline items that allow for further specification.\n\nA YouTube \\& Partners line item can have multiple\n[`AdGroup`](/display-video/api/reference/rest/v4/advertisers.adGroups) resources under it, each with its own [additional\ntargeting](/display-video/api/reference/rest/v4/advertisers.adGroups.targetingTypes.assignedTargetingOptions) and [bidding strategy](/display-video/api/reference/rest/v4/advertisers.adGroups#AdGroup.FIELDS.bid_strategy). Under each\n[`AdGroup`](/display-video/api/reference/rest/v4/advertisers.adGroups) resource can be multiple [`AdGroupAd`](/display-video/api/reference/rest/v4/advertisers.adGroupAds)\nresources of the same [ad format](/display-video/api/reference/rest/v4/advertisers.adGroups#AdGroupFormat), each with its own [creative\ninformation](/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdGroupAd.FIELDS.oneof_ad_details) and [list of additional tracking\nURLs](/display-video/api/reference/rest/v4/advertisers.adGroupAds#AdGroupAd.FIELDS.ad_urls).\n\nRetrieve targeting\n------------------\n\n[Targeting used for serving YouTube \\& Partners ads](//support.google.com/displayvideo/answer/6260055) is\nassigned at the advertiser level, line item level, and Ad Group level.\n\nYouTube \\& Partners targeting inherited from parent resources are not reflected\nin the targeting settings of child resources, as is [standard for non-YouTube\n\\& Partners resources](/display-video/api/guides/best-practices/targeting#utilize_targeting_inheritance).\n\nIn order to retrieve all targeting relevant to the serving of a YouTube \\&\nPartners ad, you must:\n\n- retrieve targeting assigned to its parent advertiser using [`advertisers.listAssignedTargetingOptions`](/display-video/api/reference/rest/v4/advertisers/listAssignedTargetingOptions),\n- retrieve targeting assigned to its parent line item using [`advertisers.lineItems.bulkListAssignedTargetingOptions`](/display-video/api/reference/rest/v4/advertisers.lineItems/bulkListAssignedTargetingOptions),\n- and retrieve targeting assigned to its parent ad group using [`advertisers.adGroups.bulkListAssignedTargetingOptions`](/display-video/api/reference/rest/v4/advertisers.adGroups/bulkListAssignedTargetingOptions).\n\n### Attempting to modify YouTube targeting\n\nAs is the case with YouTube \\& Partners resources, **you cannot modify**\n**YouTube \\& Partners targeting using the Display \\& Video 360 API**. Any attempt to modify\nthe following targeting will return an error:\n\n- Targeting assigned at any level of the following [targeting types](/display-video/api/reference/rest/v4/TargetingType): `TARGETING_TYPE_SESSION_POSITION`, `TARGETING_TYPE_YOUTUBE_CHANNEL`, and `TARGETING_TYPE_YOUTUBE_VIDEO`.\n- Targeting assigned to [YouTube \\& Partners line item resources](#line_items).\n- Targeting assigned to [`AdGroup`](/display-video/api/reference/rest/v4/advertisers.adGroups) resources.\n\nCreate and update using SDF UI upload\n-------------------------------------\n\nAlthough you cannot create or update YouTube \\& Partners resources using the\nDisplay \\& Video 360 API, you can create or update YouTube \\& Partners line items, ad groups,\nand ads in bulk using [Structured Data File (SDF) upload through the\nDisplay \\& Video 360 UI](//support.google.com/displayvideo/answer/6301070).\n\nThese resources are represented in SDF through the [Line Item](/display-video/api/structured-data-file/v6/LineItem),\n[Youtube Ad Group](/display-video/api/structured-data-file/v6/AdGroup), and [YouTube Ad](/display-video/api/structured-data-file/v6/AdGroupAd) file\nformats.\n\nYou can [generate and download Structured Data Files using\nDisplay \\& Video 360 API](/display-video/api/guides/downloading-sdfs/create). Edit existing rows to make changes to existing\nresources or add new rows for create new resources, and upload the updated\nfiles through the Display \\& Video 360 UI."]]