2025년 9월 8일부터 모든 새 광고 항목은 유럽연합 (EU) 정치 광고를 게재할지 여부를 선언해야 합니다. 선언을 제공하지 않는 Display & Video 360 API 및 SDF 업로드는 실패합니다. 통합을 업데이트하여 이 선언을 하는 방법에 대한 자세한 내용은
지원 중단 페이지를 참고하세요.
YouTube 및 파트너 광고 항목 검색
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Display & Video 360 API를 사용하여 YouTube + 파트너 광고 항목, 광고 그룹, 광고 리소스, YouTube + 파트너 광고 게재와 관련된 타겟팅을 검색할 수 있습니다. YouTube + 파트너 리소스 및 타겟팅은 UI를 통해서만 생성되거나 업데이트할 수 있습니다.
이 페이지에서는 Display & Video 360 API를 사용하여 YouTube 및 파트너 리소스를 식별하고 관련 타겟팅을 검색하는 방법과 UI에서 구조화된 데이터 파일 (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
YouTube + 파트너 광고 항목에 관한 설정은 LineItem 리소스의 youtubeAndPartnersSettings 필드에서 가져올 수 있습니다.
YouTube 광고 그룹 및 광고
YouTube 광고 그룹 및 광고는 추가 사양을 허용하는 YouTube + 파트너 광고 항목의 하위 리소스입니다.
YouTube + 파트너 광고 항목에는 각각 자체 추가 타겟팅 및 입찰 전략이 있는 여러 AdGroup 리소스가 있을 수 있습니다. 각 AdGroup 리소스 아래에는 동일한 광고 형식의 여러 AdGroupAd 리소스가 있을 수 있으며, 각 리소스에는 자체 광고 소재 정보와 추가 추적 URL 목록이 있습니다.
타겟팅 검색
YouTube 및 파트너 광고 게재에 사용되는 타겟팅은 광고주 수준, 광고 항목 수준, 광고 그룹 수준에서 할당됩니다.
상위 리소스에서 상속된 YouTube + 파트너 타겟팅은 YouTube 및 파트너가 아닌 리소스의 표준과 마찬가지로 하위 리소스의 타겟팅 설정에 반영되지 않습니다.
YouTube 및 파트너 광고 게재와 관련된 모든 타겟팅을 검색하려면 다음을 실행해야 합니다.
YouTube 타겟팅 수정 시도
YouTube 및 파트너 리소스와 마찬가지로 Display & Video 360 API를 사용하여 YouTube 및 파트너 타겟팅을 수정할 수 없습니다.
다음 타겟팅을 수정하려고 하면 오류가 반환됩니다.
SDF UI 업로드를 사용하여 만들기 및 업데이트
Display & Video 360 API를 사용하여 YouTube 및 파트너 리소스를 만들거나 업데이트할 수는 없지만 Display & Video 360 UI를 통한 구조화된 데이터 파일 (SDF) 업로드를 사용하여 YouTube 및 파트너 광고 항목, 광고 그룹, 광고를 일괄적으로 만들거나 업데이트할 수 있습니다.
이러한 리소스는 SDF에서 광고 항목, YouTube 광고 그룹, YouTube 광고 파일 형식을 통해 표현됩니다.
Display & Video 360 API를 사용하여 구조화된 데이터 파일을 생성하고 다운로드할 수 있습니다. 기존 행을 수정하여 기존 리소스를 변경하거나 새 행을 추가하여 새 리소스를 만들고 Display & Video 360 UI를 통해 업데이트된 파일을 업로드합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\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."]]
