الإيقاف نهائيًا

تسرد هذه الصفحة تواريخ الإيقاف النهائي لإصدارات واجهة برمجة التطبيقات والميزات الفردية في واجهة برمجة التطبيقات Display & Video 360 API.

سيتم أيضًا الإعلان عن عمليات الإيقاف النهائي وتواريخ الإيقاف النهائي لواجهة برمجة التطبيقات على مدونة مطوّري البرامج على "إعلانات Google".

الميزات التي سيتم إيقافها نهائيًا في الإصدار

يتم إصدار إصدارات Display & Video 360 API وإيقافها نهائيًا بشكل منتظم. يتم تحديد هذه الخطوات على النحو التالي:

• الإصدار: يخرج الإصدار من أي حالة إصدار أولي أو تجريبي ويُعدّ إصدارًا ثابتًا. قد يتم إصدار ميزات إضافية للإصدار.
• الإيقاف النهائي: سيتم إيقاف الإصدار نهائيًا وسيتم الإعلان عن تاريخ انتهاء الدعم (الإيقاف النهائي). على المستخدمين نقل البيانات إلى إصدار أحدث قبل تاريخ إيقاف الإصدار القديم. لن يتم إصدار أي ميزات إضافية لهذا الإصدار.
• إيقاف نهائي: لم يعُد الإصدار متاحًا. وستؤدي الطلبات المُرسَلة إلى الإصدار إلى ظهور رسالة خطأ.

يسرد هذا الجدول جميع الإصدارات الأساسية الحالية من Display & Video 360 API، وتواريخ إصدارها، وتواريخ إيقافها نهائيًا، في حال تم الإعلان عنها.

إصدار واجهة برمجة التطبيقات	تاريخ الإصدار	تاريخ الإيقاف النهائي	تاريخ الإيقاف النهائي	دليل نقل البيانات
v4	‫27 مارس 2025
v3	‫31 أكتوبر 2023	‫2 أبريل 2025	‫7 أكتوبر 2025	نقل البيانات من الإصدار 3 إلى الإصدار 4
v2	‫6 ديسمبر 2022	‫15 فبراير 2024	‫3 سبتمبر 2024	نقل البيانات من الإصدار 2 إلى الإصدار 3
v1	‫9 آذار (مارس) 2020	‫13 مارس 2023	‫14 سبتمبر 2023	نقل البيانات من الإصدار 1 إلى الإصدار 2

الميزات التي سيتم إيقافها نهائيًا

يمكنك متابعة مدونة مطوّري البرامج على "إعلانات Google" لمعرفة آخر الأخبار حول إيقاف الميزات المهمة نهائيًا.

يسرد هذا الجدول جميع عمليات إيقاف الميزات التي تم الإعلان عنها والتي تؤثر في الإصدارات المباشرة، ويقدّم تاريخ السريان الأولي ووصفًا لعملية الإيقاف مع الإجراءات المقترَحة وروابط تؤدي إلى المستندات ذات الصلة:

الميزة	تاريخ السريان الأوّلي	الوصف
إدارة استهداف الحملات وطلبات الإدراج في واجهة برمجة التطبيقات Display & Video 360 API وملفات البيانات المنظَّمة	‫23 فبراير 2026	في 23 فبراير 2026، سيتم إيقاف طلبات الإدراج واستهداف الحملات في "مساحة العرض والفيديو 360". سيتم إجراء تغييرات على واجهة برمجة التطبيقات لمساحة العرض والفيديو 360 وملفات البيانات المنظَّمة (SDF) بما يتوافق مع هذا التغيير. في Display & Video 360 API، سيتم إيقاف مجموعة فرعية من الطرق نهائيًا، وسيتم عرض خطأ عند استدعائها. في "إطار بيانات خدمة الإعلانات" (SDF)، لن يتم ملء أعمدة الاستهداف في ملفَي أمر الإدراج والحملة عند التنزيل، ويجب أن تكون فارغة عند التحميل. يُنصح المستخدمون بتعيين الاستهداف مباشرةً لعناصر الحملة عند إنشاء عناصر الحملة. ستعرض طرق Display & Video 360 API التالية الخطأ 404 في حال طلبها: advertisers.campaigns.listAssignedTargetingOptions advertisers.campaigns.targetingTypes.assignedTargetingOptions.get advertisers.campaigns.targetingTypes.assignedTargetingOptions.list advertisers.insertionOrders.listAssignedTargetingOptions advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.delete advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.get advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list advertisers.lineItems.generateDefault ستتعذّر عملية تحميل إدخالات الحملة في ورقة بيانات Google التي تمّ تخصيص قيم لها في الأعمدة التالية: Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Geography Targeting - Include Geography Targeting - Exclude Language Targeting - Include Language Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Environment Targeting ستتعذّر عملية تحميل إدخالات أمر الإدراج في "إطار بيانات خدمة Google" التي تمّ تعيين قيم لها في الأعمدة التالية: Geography Targeting - Include Geography Targeting - Exclude Proximity Targeting Proximity Location List Targeting Language Targeting - Include Language Targeting - Exclude Device Targeting - Include Device Targeting - Exclude Browser Targeting - Include Browser Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Channel Targeting - Include Channel Targeting - Exclude Site Targeting - Include Site Targeting - Exclude App Targeting - Include App Targeting - Exclude App Collection Targeting - Include App Collection Targeting - Exclude Category Targeting - Include Category Targeting - Exclude Content Genre Targeting - Include Content Genre Targeting - Exclude Keyword Targeting - Include Keyword Targeting - Exclude Keyword List Targeting - Exclude Audience Targeting - Include Audience Targeting - Exclude Affinity & In Market Targeting - Include Affinity & In Market Targeting - Exclude Custom List Targeting Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Daypart Targeting Daypart Targeting Time Zone Environment Targeting Viewability Omid Targeting Enabled Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Position Targeting - Audio Position In Content Video Player Size Targeting Content Duration Targeting Content Stream Type Targeting Audio Content Type Targeting Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Connection Speed Targeting Carrier Targeting - Include Carrier Targeting - Exclude
تحديد ما إذا كانت عناصر الحملة تعرض إعلانات سياسية عن الاتحاد الأوروبي	‫8 سبتمبر 2025	اعتبارًا من 8 سبتمبر 2025، سيُطلب منك الإقرار بما إذا كان عنصر الحملة سيعرض الإعلانات السياسية عن الاتحاد الأوروبي عند إنشاء عنصر حملة جديد باستخدام واجهة برمجة التطبيقات الخاصة بـ "مساحة العرض والفيديو 360" أو "تنسيقات البيانات المنظَّمة". يمكن تقديم هذه الإقرارات بالطرق التالية: استخدام الحقل containsEuPoliticalAds في مورد LineItem Display & Video 360 API يمكنك أيضًا تقديم هذا البيان باستخدام حقول جديدة في طلبات advertisers.lineItems.duplicate وadvertisers.lineItems.generateDefault. استخدام العمود Contains EU Political Ads في نوع الملف البند بتنسيق SDF الإصدار 9 إذا كان المعلِن الرئيسي لن يتضمّن أيّ بنود إعلانية تعرض الإعلانات السياسية عن الاتحاد الأوروبي، يمكنك تقديم الإقرار على مستوى المعلِن باستخدام الحقل containsEuPoliticalAds في مصدر Advertiser في واجهة برمجة التطبيقات الخاصة بـ "مساحة العرض والفيديو 360 ". إذا تم ضبط هذا الحقل على DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING، سيتمّ تعيين القيمة نفسها لجميع عناصر الحملات الجديدة ضمن المعلِن إذا لم يتم تحديد قيمة أخرى، وسيتمّ تعديل جميع عناصر الحملات الحالية ضمن المعلِن لاستخدام القيمة نفسها إذا لم يتمّ ضبط قيمة من قبل. يمكن تعديل بيان عنصر الحملة في أي وقت بعد إنشائه باستخدام واجهة المستخدِم أو واجهة برمجة التطبيقات أو "تنسيق بيانات خدمة Google". إذا لم تتمكّن من تقديم الإقرار على مستوى المعلِن أو أقررت بأنّه يمكن عرض الإعلانات السياسية عن الاتحاد الأوروبي ضمن حساب المعلِن الخاص بك، عليك تعديل عملية دمج واجهة برمجة التطبيقات "مساحة العرض والفيديو 360 " وSDF قبل 8 سبتمبر 2025 لتجنُّب انقطاع الخدمة: اضبط الحقل containsEuPoliticalAds في مورد LineItem جديد عند تقديم طلب advertisers.lineItems.create. اضبط الحقل containsEuPoliticalAds في نص الطلب لأي طلبات advertisers.lineItems.duplicate وadvertisers.lineItems.generateDefault. انتقِل إلى استخدام "ملفات البيانات المنظَّمة" الإصدار 9 واضبط العمود Contains EU Political Ads لأي عناصر سطر جديدة على Yes أو No عند التحميل. اطّلِع على دليل نقل البيانات إلى الإصدار 9 للحصول على تعليمات مفصّلة. قبل تعديل استهداف الموقع الجغرافي لعنصر حالي باستخدام واجهة برمجة التطبيقات أو SDF في "مساحة العرض والفيديو 360"، عدِّل العنصر لتقديم بيان.
إعدادات فئة المحتوى لعناصر YouTube والشركاء	‫12 يونيو 2025	في 12 يونيو 2025، لن يكون من الممكن تعديل إعدادات فئة المحتوى لفرادى بنود YouTube والشركاء كجزء من تعديل تجربة مدى الملاءمة للعلامة التجارية. بدلاً من ذلك، سيتم التحكّم في إعدادات فئات المحتوى على مستوى المعلِن فقط. لاستيعاب هذا التغيير، سيتم إجراء التغييرات التالية على واجهة برمجة التطبيقات وملفات البيانات المنظَّمة في "مساحة العرض والفيديو 360": لن يتم تعديل الحقل contentCategory في عناصر YoutubeAndPartnersSettings الخاصة بموارد LineItem على YouTube ومنصات الشركاء. وستتم إزالتها بالكامل في تاريخ لاحق. لن يكون العمود TrueView Content Filter في ملفات SDF الخاصة بعنصر الحملة قابلاً للكتابة بعد الآن. لتجنُّب أي انقطاع في الخدمة، يُرجى اتّباع ما يلي: استرداد الحقل effectiveContentCategory بدلاً من الحقل contentCategory عند مراجعة عناصر YouTube والشركاء في واجهة برمجة التطبيقات توقّف عن تعديل العمود TrueView Content Filter عند تعديل إدخالات عنصر العرض بتنسيق SDF. اترك العمود فارغًا عند إنشاء بنود جديدة.
تعديلات على ميزانية البند الإعلاني مع تحسين طلب الإدراج	‫12 يونيو 2025	اعتبارًا من 12 يونيو 2025، لن تتمكّن من تعديل إعدادات الميزانية لبنود الحملات التي تم ضبط أوامر الإدراج الرئيسية فيها على التحسين باستخدام استراتيجيات عروض الأسعار المبرمَجة. لتجنُّب أي انقطاع في الخدمة، يُرجى اتّخاذ الإجراءات التالية: في واجهة برمجة التطبيقات: تحقَّق ممّا إذا كان العنصر الرئيسي InsertionOrder لأحد عناصر الحملة يحتوي على bidStrategy.maximizeSpendAutoBid أو bidStrategy.performanceGoalAutoBid. في هذه الحالة، لا تحاول تعديل حقل ميزانية LineItem باستخدام advertisers.lineItems.patch. في SDF: تحقَّق ممّا إذا كان إدخال SDF الخاص بطلب الإدراج للعنصر الرئيسي في البند قد تم ضبط عموده Insertion Order Optimization على TRUE. في هذه الحالة، لا تحاول تعديل العمودَين Budget Type أو Budget Amount لإدخال السلعة في "إطار بيانات النقل" (SDF).
القيود المفروضة على المواقع الإلكترونية في ما يتعلّق بملفات البيانات المنظَّمة	‫12 يونيو 2025	اعتبارًا من 12 يونيو 2025، سنزيل قيدًا حاليًا على عناوين URL المستهدَفة في إدخالات SDF، والذي كان يمنع تضمين المواقع الإلكترونية الأحدث. بدلاً من ذلك، ستتطابق "إعلانات Google" مع سلوك واجهة برمجة التطبيقات وواجهة المستخدم، وستسمح باستهداف عناوين URL ما دامت منسَّقة بشكل صحيح. يكون ذلك ذا صلة بالعمودَين Site Targeting - Include وSite Targeting - Exclude في ملفَي طلب الإدراج والسلعة.
عمود "مضاعفات عروض الأسعار" في ملفات البيانات المنظَّمة الخاصة ببنود الإعلانات	‫1 مايو 2025	في 1 مايو 2025، ستتعذّر إنشاء أو تعديل الموارد في ملفات البيانات المنظَّمة لبنود الحملات التي تحاول ضبط عمود "مضاعفات عروض الأسعار" عند تحميل الملف.
طلب مصدر المساحات الإعلانية من شركاء إعلانات الفيديو لبنود "حملات زيادة الطلب" في ملفات البيانات المنظَّمة	‫22 أبريل 2025	اعتبارًا من 22 نيسان (أبريل) 2025، سيُطلب منك تضمين القيمة "شركاء الفيديو" في العمود TrueView Inventory Source Targeting لإدخالات عناصر الحملات التي تتضمّن القيمة "حملات زيادة الطلب" في العمود Type. بعد بدء إجراء التنفيذ هذا، ستتم إضافة بيانات سابقة للقيمة لعناصر الحملات الحالية وتضمينها عند تنزيل ملفات البيانات المنظَّمة الجديدة. لتجنُّب أي انقطاع في الخدمة، يُرجى اتّخاذ الإجراءات التالية: عدِّل عملية الدمج لتضمين القيمة "شركاء إعلانات الفيديو" في جميع إدخالات البنود الإعلانية في "حملات زيادة الطلب". عدِّل عملية الدمج لإدارة مصادر مستودع "حملات زيادة الطلب" على مستوى المجموعة الإعلانية باستخدام عمودَي المجموعة الإعلانية في SDF الإصدار 8.1 Demand Gen Inventory Source Strategy وDemand Gen Enabled Inventory Sources.
"حملات الفيديو التي تحثّ على اتّخاذ إجراء" في ملفات البيانات المنظَّمة	‫22 أبريل 2025	في 22 أبريل 2025، لن يعود بإمكانك إنشاء بنود في "حملات الفيديو التي تحثّ على اتّخاذ إجراء" باستخدام "ملفات البيانات المنظَّمة"، لأنّه سيتم ترقيتها إلى "حملات زيادة الطلب". ستتعذّر محاولات تحميل إدخالات البنود التي تتضمّن قيمة العمود Subtype "إجراء" وقيمة العمود Type "إعلانات TrueView". لتجنُّب أي انقطاع في الخدمة، عدِّل عملية الدمج لاستخدام "حملات زيادة الطلب" بدلاً من "حملات الفيديو التي تحثّ على اتّخاذ إجراء".
مدة عضوية غير محدودة لشرائح جمهور الطرف الأول	‫7 أبريل 2025	اعتبارًا من 7 أبريل 2025، لن تسمح موارد FirstAndThirdPartyAudience بمدة عضوية غير محدودة في شرائح الجمهور. ستعرض طلبات firstAndThirdPartyAudiences.create وfirstAndThirdPartyAudiences.patch التي تضبط قيمة الحقل membershipDurationDays على 10,000 رسالة الخطأ 400. سيتم تعديل شرائح الجمهور الحالية التي تتضمّن قيمة الحقل membershipDurationDays البالغة 10,000 إلى 540، وسيتم تطبيق مدة العضوية الجديدة بأثر رجعي على العضويات الحالية. سيؤدي ذلك إلى انتهاء صلاحية جميع العضويات التي مرّ عليها أكثر من 540 يومًا. لتجنُّب أي انقطاع في الخدمة، يُرجى اتّخاذ الإجراءات التالية: تأكَّد من أنّ عملية الدمج لا تضبط قيمة الحقل membershipDurationDays للشرائح الجديدة أو الحالية على 10,000. أعِد تحميل عضويات شرائح جمهور "مطابقة العملاء" الحالية باستخدام firstAndThirdPartyAudiences.editCustomerMatchMembers. يمكنك تعديل عضويات شرائح جمهور "مطابقة العملاء" بانتظام للتأكّد من أنّ حجم قائمة شرائح الجمهور لا يصبح أصغر عن غير قصد. في الإصدار 4، يظهر هذا التغيير في موارد FirstPartyAndPartnerAudience.
عدم تطابق خوارزمية عروض الأسعار المخصّصة مع أنشطة Floodlight	‫1 أبريل 2025	في 1 أبريل 2025: ستعرض طلبات advertisers.lineItems.create التي تحاول ضبط الحقل floodlightActivityConfigs الخاص بالكائن ConversionCountingConfig والحقل customBiddingAlgorithmId الخاص بالكائنين MaximizeSpendBidStrategy أو PerformanceGoalBidStrategy اللذين لا يستخدمان أنشطة Floodlight متطابقة، رسالة الخطأ 400. ستعرض طلبات advertisers.lineItems.patch التي تحاول تعديل الحقل floodlightActivityConfigs الخاص بالعنصر ConversionCountingConfig عندما يكون الحقل customBiddingAlgorithmId الخاص بالعنصرين MaximizeSpendBidStrategy أو PerformanceGoalBidStrategy مضبوطًا، رسالة الخطأ 400. ستتعذّر تعديل الإدخالات في ملفات البيانات المنظَّمة عناصر العرض التي تحاول تعديل عمود "أرقام تعريف نشاط الإحالة الناجحة في Floodlight" عندما يتم ضبط عمود "رقم تعريف الخوارزمية" عند تحميل الملف. ستعرض طلبات customBiddingAlgorithms.patch وcustomBiddingAlgorithms.rules.create وcustomBiddingAlgorithms.scripts.create لموارد CustomBiddingAlgorithm التي تمّ تعيينها إلى بند إعلاني خطأً. لتجنُّب أي انقطاع في الخدمة، يُرجى تعديل عملية الدمج لتصبح: تأكَّد من أنّ أنشطة Floodlight ذات الصلة تمّ تعيينها لبندّ إعلان قبل أو في الوقت نفسه الذي تمّ فيه تعيين خوارزمية عروض أسعار مخصّصة. يتم إلغاء ربط خوارزميات عروض الأسعار المخصّصة الحالية بجميع بنود الإعلانات قبل محاولة تعديلها.

عمليات إيقاف الميزات السابقة نهائيًا

للاطّلاع على عمليات الإيقاف النهائي التي تم الإعلان عنها والتي تؤثّر في الإصدارات التي سيتم إيقافها نهائيًا من Display & Video 360 API، يُرجى الاطّلاع على عمليات الإيقاف النهائي المؤرشفة.