ตั้งแต่วันที่
8 กันยายน 2025 เป็นต้นไป รายการโฆษณาใหม่ทุกรายการจะต้องประกาศว่าจะแสดงโฆษณาทางการเมืองในสหภาพยุโรป (EU) หรือไม่ การอัปโหลด API ของ Display & Video 360 และ SDF ที่ไม่ได้ระบุการประกาศจะล้มเหลว ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีอัปเดตการผสานรวมเพื่อประกาศนี้ได้ที่
หน้าการเลิกใช้งาน
เรียกข้อมูลบรรทัดรายการ YouTube & Partners
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
คุณสามารถเรียกข้อมูลรายการโฆษณาของ YouTube และพาร์ทเนอร์ กลุ่มโฆษณา และชิ้นงานโฆษณา รวมถึงการกำหนดเป้าหมายที่เกี่ยวข้องกับการแสดงโฆษณาของ YouTube และพาร์ทเนอร์ได้โดยใช้ Display & Video 360 API คุณสร้างแหล่งข้อมูลและการกำหนดเป้าหมายของ YouTube และพาร์ทเนอร์ได้
หรืออัปเดตผ่าน UI เท่านั้น
หน้านี้อธิบายวิธีใช้ Display & Video 360 API เพื่อระบุแหล่งข้อมูลของ YouTube และพาร์ทเนอร์ รวมถึงดึงข้อมูลการกําหนดเป้าหมายที่เกี่ยวข้อง และวิธีสร้างและอัปเดตแหล่งข้อมูลของ YouTube และพาร์ทเนอร์หลายรายการพร้อมกันโดยใช้ไฟล์ Structured Data (SDF) ใน UI
ระบุแหล่งข้อมูลของ 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 และพาร์ทเนอร์ได้จากช่อง youtubeAndPartnersSettings ของแหล่งข้อมูล LineItem
กลุ่มโฆษณาและโฆษณา YouTube
กลุ่มโฆษณาและโฆษณา YouTube เป็นทรัพยากรย่อยภายใต้รายการโฆษณา YouTube และพาร์ทเนอร์ที่อนุญาตให้ระบุรายละเอียดเพิ่มเติมได้
รายการโฆษณา YouTube และพาร์ทเนอร์อาจมีแหล่งข้อมูล AdGroup หลายรายการ โดยแต่ละรายการมีการกำหนดเป้าหมายและกลยุทธ์การเสนอราคาเพิ่มเติมของตนเอง ภายใต้แหล่งข้อมูลAdGroup แต่ละรายการอาจมีแหล่งข้อมูล AdGroupAd หลายรายการของรูปแบบโฆษณาเดียวกัน โดยแต่ละรายการจะมีข้อมูลครีเอทีฟโฆษณาและรายการ URL ติดตามเพิ่มเติมของตนเอง
เรียกข้อมูลการกำหนดเป้าหมาย
การกำหนดเป้าหมายที่ใช้เพื่อแสดงโฆษณา YouTube และพาร์ทเนอร์จะกำหนดที่ระดับผู้ลงโฆษณา ระดับรายการโฆษณา และระดับกลุ่มโฆษณา
การกำหนดเป้าหมาย YouTube และพาร์ทเนอร์ที่รับค่าจากทรัพยากรหลักจะไม่แสดงในการตั้งค่าการกำหนดเป้าหมายของทรัพยากรย่อยตามมาตรฐานสำหรับทรัพยากรที่ไม่ใช่ของ YouTube และพาร์ทเนอร์
หากต้องการเรียกข้อมูลการกำหนดเป้าหมายทั้งหมดที่เกี่ยวข้องกับการแสดงโฆษณา YouTube และพาร์ทเนอร์ คุณต้องดำเนินการดังนี้
พยายามแก้ไขการกำหนดเป้าหมายบน YouTube
เช่นเดียวกับแหล่งข้อมูลของ YouTube และพาร์ทเนอร์ คุณไม่สามารถแก้ไข
การกำหนดเป้าหมาย YouTube และพาร์ทเนอร์โดยใช้ Display & Video 360 API การพยายามแก้ไขการกําหนดเป้าหมายต่อไปนี้จะแสดงข้อผิดพลาด
สร้างและอัปเดตโดยใช้การอัปโหลด UI SDF
แม้ว่าคุณจะสร้างหรืออัปเดตทรัพยากรของ YouTube และพาร์ทเนอร์โดยใช้ Display & Video 360 API ไม่ได้ แต่คุณสร้างหรืออัปเดตรายการโฆษณา กลุ่มโฆษณา และโฆษณาของ YouTube และพาร์ทเนอร์ได้ทีละหลายรายการโดยใช้การอัปโหลดไฟล์ Structured Data (SDF) ผ่าน UI ของ Display & Video 360
แหล่งข้อมูลเหล่านี้แสดงใน SDF ผ่านรูปแบบไฟล์รายการโฆษณา กลุ่มโฆษณา YouTube และโฆษณา YouTube
คุณสามารถสร้างและดาวน์โหลดไฟล์ Structured Data โดยใช้ Display & Video 360 API แก้ไขแถวที่มีอยู่เพื่อทําการเปลี่ยนแปลงแหล่งข้อมูลที่มีอยู่ หรือเพิ่มแถวใหม่เพื่อสร้างแหล่งข้อมูลใหม่ และอัปโหลดไฟล์ที่อัปเดตแล้วผ่าน UI ของ Display & Video 360
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ 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."]]
