از
8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (EU) را ارائه می دهد یا خیر. Display & Video 360 API و بارگذاری‌های SDF که اعلان‌ها را ارائه نمی‌کنند با شکست مواجه می‌شوند. برای جزئیات بیشتر در مورد نحوه به روز رسانی یکپارچه سازی خود برای ایجاد این اعلامیه، به
صفحه لغو اعتبار ما مراجعه کنید.
بازیابی YouTube & اقلام خط شرکا
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
با استفاده از Display & Video 360 API می‌توانید موارد خط YouTube & Partners، گروه‌های تبلیغاتی و منابع تبلیغاتی آن‌ها و هدف‌یابی مربوط به ارائه آگهی YouTube & Partners را بازیابی کنید. منابع و اهداف YouTube & Partners فقط از طریق رابط کاربری ایجاد یا به‌روزرسانی می‌شوند .
در این صفحه نحوه استفاده از Display & Video 360 API برای شناسایی منابع YouTube & Partners و بازیابی اهداف مرتبط، و نحوه ایجاد و به‌روزرسانی منابع YouTube & Partners به صورت انبوه با استفاده از فایل‌های داده ساختاریافته (SDF) در رابط کاربری توضیح داده شده است.
منابع YouTube و Partners را شناسایی کنید
منابع YouTube & Partners شامل انواع خاصی از موارد خط، گروه‌های تبلیغاتی و تبلیغات است.
موارد خط
موارد خط مقادیر LineItemType زیر موارد خط YouTube & Partners هستند و نمی‌توانند ایجاد یا به‌روزرسانی شوند :
-
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
تنظیمات مربوط به موارد خط YouTube & Partners را می توان از قسمت youtubeAndPartnersSettings منبع LineItem بازیابی کرد.
گروه ها و تبلیغات YouTube Ad
گروه‌ها و آگهی‌های تبلیغات YouTube منابعی هستند که در زیر آیتم‌های خط YouTube & Partner قرار دارند که امکان مشخصات بیشتر را فراهم می‌کنند.
یک آیتم خط YouTube & Partners می‌تواند چندین منبع AdGroup را در زیر خود داشته باشد که هر کدام استراتژی هدف‌یابی و پیشنهاد قیمت اضافی خود را دارند. در زیر هر منبع AdGroup می توان چندین منبع AdGroupAd با همان قالب تبلیغاتی وجود داشت که هر کدام دارای اطلاعات خلاقانه و فهرست URL های ردیابی اضافی هستند.
بازیابی هدف گذاری
هدف‌گیری که برای ارائه آگهی‌های YouTube & Partners استفاده می‌شود در سطح آگهی‌دهنده، سطح آیتم خط و سطح گروه آگهی اختصاص داده می‌شود.
هدف YouTube & Partners که از منابع والدین به ارث رسیده است، همانطور که برای منابع غیر YouTube & Partners استاندارد است، در تنظیمات هدف‌یابی منابع فرزند منعکس نمی‌شود.
برای بازیابی همه اهداف مرتبط با ارائه آگهی YouTube و شرکا، باید:
تلاش برای تغییر هدف گذاری YouTube
همانطور که در مورد منابع YouTube & Partners صدق می کند، نمی توانید هدف گذاری YouTube & Partners را با استفاده از Display & Video 360 API تغییر دهید. هر تلاشی برای اصلاح هدف گذاری زیر یک خطا برمی گرداند:
- هدف گذاری در هر سطحی از انواع هدف گذاری زیر اختصاص داده شده است:
TARGETING_TYPE_SESSION_POSITION ، TARGETING_TYPE_YOUTUBE_CHANNEL ، و TARGETING_TYPE_YOUTUBE_VIDEO . - هدف گذاری به منابع مورد خط YouTube & Partners اختصاص داده شده است.
- هدف گذاری اختصاص داده شده به منابع
AdGroup .
ایجاد و به روز رسانی با استفاده از آپلود SDF UI
اگرچه نمی‌توانید منابع YouTube & Partners را با استفاده از Display & Video 360 API ایجاد یا به‌روزرسانی کنید، می‌توانید موارد خط YouTube & Partners، گروه‌های تبلیغاتی و تبلیغات را به صورت انبوه با استفاده از آپلود فایل داده ساخت‌یافته (SDF) از طریق رابط کاربری Display & Video 360 ایجاد یا به‌روزرسانی کنید .
این منابع در SDF از طریق فرمت‌های فایل Line Item ، Youtube Ad Group و YouTube Ad نمایش داده می‌شوند.
می‌توانید فایل‌های داده ساختاریافته را با استفاده از Display & Video 360 API تولید و دانلود کنید . ردیف‌های موجود را ویرایش کنید تا تغییراتی در منابع موجود ایجاد کنید یا ردیف‌های جدیدی را برای ایجاد منابع جدید اضافه کنید و فایل‌های به‌روزرسانی‌شده را از طریق Display & Video 360 UI آپلود کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
