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

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

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

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

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

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

يسرد الجدول أدناه جميع الشبكات الأساسية الحالية إصدارات Video 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. التغييرات ذات الصلة على "الشبكة الإعلانية" تم الإعلان عن سلوك واجهة برمجة التطبيقات Video 360 API وملفات البيانات المنظَّمة والإجراءات المقترَحة في مشاركة مدونة.
المشغلات اليدوية ‫17 أيار (مايو) 2023

المخطّط الزمني:

  • 17 أيار (مايو) 2023: سيتوقّف عرض تفاصيل الإعلان التي تستخدم عوامل التشغيل اليدوية في "الشبكة الإعلانية" فيديو 360. في حال تفعيل عامل تشغيل يدوي مرتبط بعنصر نشط بعد هذا التاريخ، لن يعرض العنصر إعلانات.
  • 1 آب (أغسطس) 2023: سيتم إيقاف خدمة advertisers.manualTriggers في الإصدارَين الأول والثاني من واجهة برمجة التطبيقات من "مساحة العرض والفيديو 360"، وقيمة التعداد LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER في الإصدار الأول من "مساحة العرض والفيديو 360"، والحقل LineItemFlight.triggerId في الإصدار الأول من "مساحة العرض والفيديو 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 الحالية والتأكّد من أنّها تستخدم عامل التشغيل المنطقي 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، وستتم أرشفة تفاصيل الإعلان الفرعية.

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

الحقل publisherReviewStatuses في الموارد الإبداعية 26 يونيو 2024

اعتبارًا من 26 يونيو 2024، سيتم إيقاف الحقل publisherReviewStatuses نهائيًا وسيكون فارغًا عند استرداد موارد Creative.

مجموعة فرعية من استهداف المحتوى في YouTube عناصر الشركاء 30 سبتمبر 2024

في 30 أيلول (سبتمبر) 2024، سيتم عرض القيم التالية إيقاف أنواع الاستهداف في YouTube عناصر الشركاء:

ستتم إزالة خيارات استهداف تاريخ الإيقاف النهائي تلقائيًا من استهداف العناصر الحالية.

لتجنُّب أي انقطاع في الخدمة، عليك إزالة هذا الاستهداف من أي قناة حالية على 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.