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

تعرض هذه الصفحة تواريخ إيقاف إصدارات واجهة برمجة التطبيقات والميزات الفردية في واجهة برمجة التطبيقات لمساحة العرض والفيديو 360.

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

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

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

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

يسرد الجدول التالي جميع الإصدارات الأساسية الحالية لواجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"، و تواريخ إصدارها ، وتواريخ إيقافها نهائيًا، إذا تم الإعلان عنها.

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

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

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

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

الميزة	تاريخ السريان الأولي	الوصف
توسيع نطاق الاستهداف	25 آذار (مارس) 2023	استبدال ميزة توسيع نطاق الاستهداف بميزة الاستهداف المحسّن، وتم طرحها تدريجيًا من 25 آذار (مارس) 2023 إلى أوائل أيار (مايو) 2023. تم الإعلان في مقالة مدوّنة عن التغييرات ذات الصلة في واجهة برمجة التطبيقات Display & Video 360 API وسلوك ملفات البيانات المنظَّمة، بالإضافة إلى الإجراءات المقترَحة.
العوامل التي تؤدي إلى ظهور الإعلانات يدويًا	‫17 أيار (مايو) 2023	المخطّط الزمني: 17 أيار (مايو) 2023: سيتم إيقاف عرض العناصر التي تستخدم عوامل تشغيل يدوية في "مساحة العرض والفيديو 360". إذا فعّلت عامل تشغيل يدويًا مرتبطًا ببند نشط بعد هذا التاريخ، لن يعرض البند الإعلانات. 1 آب (أغسطس) 2023: سيتم إيقاف خدمة advertisers.manualTriggers في الإصدارَين 1 و2 من DV360 API، وقيمة القائمة المحدّدة LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER في الإصدار 1 من DV360 API، والحقل LineItemFlight.triggerId في الإصدار 1 من DV360 API نهائيًا. وبعد هذا التاريخ، ستؤدي الطلبات المقدَّمة إلى هذه الخدمات أو إلى هذه الحقول إلى ظهور خطأ. الإجراءات المقترحة: توقّف فورًا عن استخدام عوامل التشغيل اليدوية لبدء عرض العناصر وإيقافه. توقّف عن إرسال طلبات إلى خدمة advertisers.manualTriggers. عدِّل حقلَي flight.flightDateType وflight.triggerId لجميع العناصر باستخدام عوامل التشغيل اليدوية.
أنواع التطبيقات المثبَّتة والأجهزة الجوّالة الجديدة GoogleAudience	20 أيار (مايو) 2023	المخطّط الزمني: 20 أيار (مايو) 2023: لن يعود بإمكانك تخصيص موارد GoogleAudience التي لها قيمة GoogleAudienceType تبلغ GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS أو GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES لاستهداف الجمهور في البند أو طلب الإدراج. سيؤدي طلب تعيين شرائح الجمهور هذه إلى استهداف الجمهور في أحد العناصر إلى ظهور خطأ. ويشمل ذلك طلبات advertisers.lineItems.duplicate وadvertisers.lineItems.generateDefault، إذا كان العنصر الذي تم إنشاؤه سيتضمّن شرائح جمهور متوقّفة نهائيًا في استهداف الجمهور. 8 حزيران (يونيو) 2023: ستتم إزالة شرائح الجمهور المتأثرة من جميع استهدافات العناصر والطلبات، ومن جميع شرائح الجمهور المجمّعة. إذا لم يتمكّن أحد العناصر من عرض الإعلانات عند إزالة شرائح الجمهور هذه، سيتم إيقافه مؤقتًا. في هذا التاريخ، لن تتمكّن أيضًا من استرداد شرائح الجمهور هذه باستخدام خدمة googleAudiences. المهام المقترَحة: ننصحك بالتوقف فورًا عن استخدام شرائح الجمهور المتأثرة عند إجراء تعديلات مستقبلية على استهداف العناصر. أزِل جميع شرائح الجمهور المتأثرة من استهداف العناصر الحالية وطلبات الإدراج. يمكنك الاطّلاع على مزيد من المعلومات عن تعديل استهداف الجمهور في دليل الجماهير المستهدَفة.
أنواع الإعلانات المستندة إلى الأنشطة وتحديد عدد مرّات الظهور FirstAndThirdPartyAudience	20 أيار (مايو) 2023	المخطّط الزمني: 20 أيار (مايو) 2023: لن يعود بإمكانك تخصيص موارد FirstAndThirdPartyAudience التي لها قيمة AudienceType تبلغ ACTIVITY_BASED أو FREQUENCY_CAP لاستهداف الجمهور في البند أو طلب الإدراج. سيؤدي طلب تعيين شرائح الجمهور هذه إلى استهداف الجمهور في أحد العناصر إلى ظهور خطأ. ويشمل ذلك طلبات advertisers.lineItems.duplicate وadvertisers.lineItems.generateDefault، إذا كان العنصر الذي تم إنشاؤه سيتضمّن شرائح جمهور متوقّفة نهائيًا في استهداف الجمهور. 8 حزيران (يونيو) 2023: ستتم إزالة شرائح الجمهور المتأثرة من جميع استهدافات العناصر والطلبات، ومن جميع شرائح الجمهور المجمّعة. إذا لم يتمكّن أحد العناصر من عرض الإعلانات عند إزالة شرائح الجمهور هذه، سيتم إيقافه مؤقتًا. في هذا التاريخ، لن تتمكّن أيضًا من استرداد شرائح الجمهور هذه باستخدام خدمة firstAndThirdPartyAudiences. المهام المقترَحة: ننصحك بالتوقف فورًا عن استخدام شرائح الجمهور المتأثرة عند إجراء تعديلات مستقبلية على استهداف العناصر. أزِل جميع شرائح الجمهور المتأثرة من استهداف العناصر الحالية وطلبات الإدراج. يمكنك الاطّلاع على مزيد من المعلومات عن تعديل استهداف الجمهور في دليل الجماهير المستهدَفة.
الحدود الحالية لحصص واجهة برمجة التطبيقات	30 أيار (مايو) 2023	في 30 أيار (مايو) 2023، سيتم استبدال حدود الاستخدام الحالية ببنية حصة مختلطة تُجري ما يلي: يزيل الحصة اليومية للطلبات لكل مشروع. تُنشئ حصة طلبات في الدقيقة لكلّ مُعلِن لكلّ مشروع للطرق المؤهّلة. ستتيح هذه الحدود الجديدة مرونة أكبر في استخدام واجهة برمجة التطبيقات وستسمح بإجراء الطلبات بشكل موازٍ على مستوى المعلِنين. يمكنك الاطّلاع على تفاصيل هذا التغيير في مستندات حدود الحصة الحالية.
استخدام عامل التشغيل OR بين قيود الحقول المختلفة في فلاتر LIST تم تعديل تاريخ السريان الأوّلي	‫21 حزيران (يونيو) 2023	في 21 حزيران (يونيو) 2023، لن تسمح مَعلمات LIST طلب filter بعد ذلك باستخدام عوامل التشغيل المنطقية OR بين قيود الحقول المختلفة. على سبيل المثال، يجب استرداد الموارد التي تم تحديدها باستخدام سلسلة الفلتر lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" باستخدام طلبَي LIST مع سلاسل الفلتر التالية: lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" insertionOrderId="123" يمكنك الرجوع إلى دليل كيفية فلترة طلبات LIST للحصول على مزيد من التفاصيل حول قيود عوامل التشغيل المنطقية. يُرجى مراجعة مَعلمات طلب البحث filter لجميع طلبات LIST الحالية والتأكّد من أنّها تستخدم المشغِّل المنطقي OR بشكل صحيح قبل 21 حزيران (يونيو) 2023 لتجنُّب انقطاع الخدمة.
إمكانية فلترة طلبات القوائم أو ترتيبها حسب حقلَي budget.budget_segments.date_range.end_date وflight.dateRange.endDate تم تعديل تاريخ السريان الأولي	‫21 حزيران (يونيو) 2023	في 21 حزيران (يونيو) 2023، لن يُسمح باستخدام الحقلَين budget.budget_segments.date_range.end_date وflight.dateRange.endDate في مَعلمتَي طلب البحث advertisers.insertionOrders.list وadvertisers.lineItems.list filter وorderBy، على التوالي. بعد هذا التاريخ، ستؤدي الطلبات التي تستخدِم هذين الحقلين في مَعلمتَي طلب البحث filter وorderBy إلى ظهور خطأ. عليك إزالة كل منطق الفلتر والترتيب باستخدام هذين الحقلين قبل 21 حزيران (يونيو) 2023 لتجنُّب انقطاع الخدمة.
إمكانية فلترة طلبات advertisers.lineItems.list حسب أربعة حقول إضافية	‫21 حزيران (يونيو) 2023	اعتبارًا من 21 حزيران (يونيو) 2023، لن تعود advertisers.lineItems.list تتيح الفلترة حسب الحقول التالية: flight.triggerId targetedChannelId targetedNegativeKeywordListId warningMessages عليك إزالة كل منطق الفلتر باستخدام هذه الحقول الأربعة قبل 21 حزيران (يونيو) 2023 لتجنُّب انقطاع الخدمة.
الشراء المستنِد إلى النتائج	1 أغسطس 2023	في 1 آب (أغسطس) 2023، سيتمّ أرشفة طلبات الإدراج التي تستخدِم ميزة "الشراء المستنِد إلى النتائج"، والتي يتمّ تحديدها من خلال قيمة حقل billableOutcome التي تبلغ BILLABLE_OUTCOME_PAY_PER_CLICK أو BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION، وعناصرها الفرعية. سيؤثّر هذا التغيير في الطلبات التالية: سيؤدي محاولة استخدام advertisers.insertionOrders.create لإنشاء طلب إدراج باستخدام "الشراء المستنِد إلى النتائج" إلى ظهور خطأ 400. سيؤدي محاولة استخدام advertisers.lineItems.create أو advertisers.lineItems.duplicate أو advertisers.lineItems.generateDefault لإنشاء عنصر ضمن طلب إدراج باستخدام "الشراء المستنِد إلى النتائج" إلى ظهور خطأ 400. بما أنّه لا يتم تضمين الموارد المؤرشفة في طلبات LIST تلقائيًا، لن يتم عرض الموارد المتأثرة من خلال الطريقتَين advertisers.insertionOrders.list وadvertisers.lineItems.list تلقائيًا.
حقل publisherReviewStatuses في الموارد الإبداعية	‫26 يونيو 2024	اعتبارًا من 26 حزيران (يونيو) 2024، سيتم إيقاف حقل publisherReviewStatuses نهائيًا وسيكون فارغًا عند استرداد موارد Creative.
استهداف المحتوى لعناصر YouTube والشركاء	30 أيلول (سبتمبر) 2024	في 30 أيلول (سبتمبر) 2024، سيتم إيقاف القيم التالية لأنواع الاستهداف المحدّدة نهائيًا في عناصر YouTube والشركاء: TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION: CONTENT_RATING_TIER_UNRATED CONTENT_RATING_TIER_GENERAL CONTENT_RATING_TIER_PARENTAL_GUIDANCE CONTENT_RATING_TIER_TEENS CONTENT_RATING_TIER_MATURE CONTENT_RATING_TIER_FAMILIES TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION: SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO ستتم إزالة خيارات الاستهداف التي سيتم إيقافها نهائيًا تلقائيًا من استهداف عناصر السطر الحالية. وستظلّ هذه القيم متاحة للاستخدام في الاستهداف على مستوى المعلِن. لتجنُّب أي انقطاع في الخدمة، يُرجى إزالة هذا الاستهداف من أيّ عناصر حالية من النوع "YouTube والشركاء" قبل تاريخ الإيقاف النهائي.
شرائح جمهور Oracle التابعة للطرف الأول والتابعة لجهات خارجية	30 أيلول (سبتمبر) 2024	في 30 أيلول (سبتمبر) 2024، سيتم إيقاف مصادر الموارد من FirstAndThirdPartyAudience التابعة لشركة Oracle نهائيًا. عند إيقاف هذه الميزة نهائيًا، ستتم إزالة شرائح الجمهور هذه من أيّ استهداف حالي للموارد وجمهور مجمّع. إذا كان أحد العناصر يستهدف شرائح جمهور ستتم إزالتها فقط أو يستهدف بشكل سلبي أي شرائح جمهور ستتم إزالتها، سيؤدي هذا التعديل إلى إيقاف هذا العنصر مؤقتًا تلقائيًا. لتجنُّب أي انقطاع في الخدمة، عليك تحديد أي شرائح جمهور من Oracle وإزالتها من شرائح الجمهور المستهدَفة الحالية للعناصر وشرائح الجمهور المجمّعة قبل تاريخ الإيقاف النهائي.
الاستهداف المحسَّن لعنصر الإعلان لمجموعة فرعية من استراتيجيات عروض الأسعار	30 أيلول (سبتمبر) 2024	في 30 أيلول (سبتمبر) 2024، لن تعود موارد LineItem التي تستخدم مجموعة فرعية من استراتيجيات عروض الأسعار متوافقة مع الاستهداف المحسّن. بعد إجراء هذا التغيير، سيتم تعديل موارد LineItem التي تم ضبط targetingExpansion.enableOptimizedTargeting فيها على True وbidStrategy.maximizeSpendAutoBid.performanceGoalType فيها على BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA أو BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN أو BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED أو bidStrategy.performanceGoalAutoBid.performanceGoalType فيها على BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM لضبط targetingExpansion.enableOptimizedTargeting فيها على False. لتجنُّب أي انقطاع في الخدمة، عليك تعديل العناصر التي تستخدم استراتيجيات عروض الأسعار هذه والتأكّد من أنّه لم يتم تفعيل الاستهداف المحسّن فيها.
عرض الإعلانات في أقرب وقت ممكن Pacing لطلبات الإدراج	5 نوفمبر 2024	في 5 تشرين الثاني (نوفمبر) 2024، لن يكون PACING_TYPE_ASAP متوافقًا مع PACING_PERIOD_FLIGHT عند ضبط حقل ترتيب الإدراج pacing. سيتم تعديل pacingType لجميع طلبات الإدراج الحالية التي تستخدم هذا الإعداد إلى PACING_TYPE_AHEAD. لتجنُّب أي انقطاع في الخدمة، عدِّل pacing لأي طلبات إدراج حالية باستخدام PACING_TYPE_ASAP وPACING_PERIOD_FLIGHT.
مدة الاشتراك غير المحدودة لشرائح جمهور الطرف الأول	7 نيسان (أبريل) 2025	في 7 نيسان (أبريل) 2025، لن تسمح موارد FirstAndThirdPartyAudience بعد ذلك بمدة عضوية غير محدودة في شريحة الجمهور. سيؤدي طلبَا firstAndThirdPartyAudiences.create وfirstAndThirdPartyAudiences.patch إلى عرض خطأ 400 في حال ضبط قيمة الحقل membershipDurationDays على 10,000. سيتم تعديل شرائح الجمهور الحالية التي تبلغ قيمة حقل membershipDurationDays فيها 10,000 إلى 540، وسيتم تطبيق مدة الاشتراك الجديدة بأثر رجعي على الاشتراكات الحالية. سيؤدي ذلك إلى انتهاء صلاحية جميع العضويات التي مرّ عليها أكثر من 540 يومًا. لتجنُّب أي انقطاع في الخدمة: تأكَّد من أنّ عملية الدمج لا تضبط قيمة حقل membershipDurationDays للجماهير الجديدة أو الحالية على 10,000. أعِد تحميل عضويات شرائح جمهور "مطابقة العملاء" الحالية باستخدام firstAndThirdPartyAudiences.editCustomerMatchMembers. عليك إعادة تحميل عضويات شرائح جمهور "مطابقة العملاء" بانتظام للتأكّد من عدم صغر حجم قائمة شرائح جمهورك عن غير قصد.