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

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

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

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

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

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

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

إصدار واجهة برمجة التطبيقات تاريخ الإصدار تاريخ الإيقاف تاريخ الغروب دليل نقل البيانات
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 والثاني من واجهة برمجة تطبيقات "مساحة العرض والفيديو 360"، وقيمة التعداد LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER في الإصدار 1 من واجهة برمجة تطبيقات "مساحة العرض والفيديو 360"، والحقل LineItemFlight.triggerId في الإصدار 1 من واجهة برمجة تطبيقات "مساحة العرض والفيديو 360". بعد هذا التاريخ، ستعرض الطلبات المقدّمة إلى هذه الخدمات أو إلى هذه الحقول رسالة خطأ.

الإجراءات المقترحة:

  • التوقف فورًا عن استخدام عوامل التشغيل اليدوية لبدء عرض تفاصيل الإعلان وإيقافه
  • يمكنك إيقاف إرسال طلبات إلى خدمة 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، سيتم استبدال حدود الاستخدام الحالية ببنية حصة مختلطة تنطبق على ما يلي:

  1. إزالة حصة الطلبات اليومية لكل مشروع.
  2. إنشاء حصة عدد الطلبات في الدقيقة لكل معلن في كل مشروع لاستخدامها في طرق التأهيل.

ستسمح هذه الحدود الجديدة بمرونة أكبر في استخدام واجهة برمجة التطبيقات، كما تتيح تزامن الطلبات بين المعلِنين. تتوفّر تفاصيل هذا التغيير في مستنداتنا الحالية حول الحدّ الأقصى للحصة.
استخدام عامل التشغيل OR بين قيود الحقول المختلفة في LIST من الفلاتر

‫21 حزيران (يونيو) 2023

في 21 حزيران (يونيو) 2023، لن تسمح مَعلمات filter لطلب LIST باستخدام عوامل التشغيل المنطقية OR بعد ذلك.

على سبيل المثال، يجب بدلاً من ذلك استرداد الموارد المحددة بسلسلة الفلتر lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" باستخدام طلبَي LIST مع سلاسل الفلاتر التالية:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

للاطّلاع على مزيد من التفاصيل حول قيود عوامل التشغيل المنطقية، يمكنك الرجوع إلى دليل طريقة التنفيذ حول فلترة طلبات LIST.

يُرجى مراجعة مَعلمات طلب البحث filter لجميع طلبات LIST الحالية والتأكّد من أنّها تستخدم عامل التشغيل "أو" المنطقي بشكل صحيح قبل 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، والعناصر الفرعية.

سيؤثر هذا التغيير في الطلبات التالية: