اعتبارًا من
8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على
صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
استرداد عناصر YouTube والشركاء
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك استرداد تفاصيل الإعلانات على YouTube ومنصات الشركاء ومجموعاتها الإعلانية ومقاييسها الإعلانية واستهدافها ذي الصلة بعرض إعلانات YouTube ومنصات الشركاء باستخدام واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360". لا يمكن إنشاء مراجع واستهدافات YouTube والشركاء إلا
أو تعديلها من خلال واجهة المستخدم.
توضّح هذه الصفحة كيفية استخدام Display & Video 360 API لتحديد موارد YouTube & Partners
واسترداد الاستهداف ذي الصلة، وكيفية إنشاء موارد YouTube
& Partners وتعديلها بشكلٍ مجمّع باستخدام ملفات البيانات المنظَّمة (SDF) في واجهة المستخدِم.
تحديد موارد 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. ستؤدي أي محاولة لتعديل
الاستهداف التالي إلى ظهور خطأ:
- الاستهداف الذي تمّ تعيينه على أيّ مستوى من أنواع الاستهداف التالية:
TARGETING_TYPE_SESSION_POSITION وTARGETING_TYPE_YOUTUBE_CHANNEL و
TARGETING_TYPE_YOUTUBE_VIDEO
- الاستهداف الذي تمّ تعيينه لمصادر عناصر YouTube والشركاء
- الاستهداف الذي تمّ إسناده إلى موارد
AdGroup
الإنشاء والتحديث باستخدام واجهة المستخدم لتحميل ملف SDF
على الرغم من أنّه لا يمكنك إنشاء موارد YouTube والشركاء أو تعديلها باستخدام واجهة برمجة التطبيقات لمساحة العرض والفيديو 360، يمكنك إنشاء أو تعديل تفاصيل إعلانات YouTube والشركاء والمجموعات الإعلانية
والإعلانات بشكلٍ مجمّع باستخدام تحميل ملف البيانات المنظَّمة (SDF) من خلال واجهة مستخدم "مساحة العرض والفيديو 360".
يتم تمثيل هذه المراجع في تنسيق SDF من خلال تنسيقات الملفات العنصر
المجموعة الإعلانية على YouTube والإعلان على YouTube.
يمكنك إنشاء ملفات البيانات المنسّقة وتنزيلها باستخدام
واجهة برمجة التطبيقات لمساحة العرض والفيديو 360. عدِّل الصفوف الحالية لإجراء تغييرات على مواردك
الحالية أو أضِف صفوفًا جديدة لإنشاء موارد جديدة، وحمِّل الملفات المعدَّلة
من خلال واجهة مستخدم "مساحة العرض والفيديو 360".
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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."]]
