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

عند طرح إصدار جديد، يتم تحديد تاريخ إنهاء العمل بالإصدار القديم، وبعد هذا التاريخ، لن يعود هذا الإصدار متاحًا. في ما يلي بعض الإرشادات الأخرى التي يجب أخذها في الاعتبار:

• نسعى جاهدين لإبقاء أربعة إصدارات رئيسية على الأكثر متاحة في أي وقت.
• تتراوح مدة صلاحية الإصدارات الرئيسية بين 12 شهرًا، أما الإصدارات الثانوية فتبلغ 10 أشهر.
• عليك إجراء ترقيتَين كحدّ أقصى في السنة، وليس عليك إجراء الترقية بترتيب تسلسلي صارم، فيمكنك مثلاً الترقية من الإصدار (N) إلى الإصدار (N+2) مباشرةً.
• يجب أن يكون هناك تداخل بين تاريخ إصدار جميع مكتبات البرامج للعملاء لأحدث إصدار وتاريخ إيقاف الإصدار نهائيًا لمدة 20 أسبوعًا على الأقل.

تتوافق مكتبات العملاء مع أي إصدارات متاحة من الخدمة، ما يتيح لك الترقية تدريجيًا من خلال تحديد إصدارات مختلفة من الخدمات المستخدَمة.

جدول المواعيد

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

إصدار واجهة برمجة التطبيقات	تاريخ الإصدار	تاريخ الإيقاف النهائي	دليل الترقية
الإصدارات التي تم طرحها
v21	‫6 أغسطس 2025	أغسطس 2026 (تاريخ مبدئي)	الترقية من الإصدار 20 إلى الإصدار 21
v22	‫15 أكتوبر 2025	أكتوبر 2026 (تاريخ مبدئي)	الترقية من الإصدار 21 إلى الإصدار 22
v23	‫28 يناير 2026	فبراير 2027	الترقية من الإصدار 22 إلى الإصدار 23
v23.1	‫25 فبراير 2026	فبراير 2027	الترقية من الإصدار 23 إلى الإصدار 23.1
v23.2	‫25 مارس 2026	فبراير 2027	الترقية من الإصدار 23.1 إلى الإصدار 23.2
v24	‫22 أبريل 2026	مايو 2027	الترقية من الإصدار 23.2 إلى الإصدار 24
v24.1	‫13 مايو 2026	مايو 2027	الترقية من الإصدار 24 إلى الإصدار 24.1
الإصدارات القادمة
v24.2	يونيو 2026	مايو 2027
v25	يوليو 2026	أغسطس 2027
v25.1	أغسطس 2026	أغسطس 2027
v25.2	سبتمبر 2026	أغسطس 2027
v26	تشرين الأول (أكتوبر) 2026	نوفمبر 2027
الإصدار 26.1*	نوفمبر 2026	نوفمبر 2027

* تم تصنيف الإصدار 26.1 كإصدار اختياري بسبب تداخله مع موسم العطلات.

عرض الإصدارات التي يستخدمها مشروعك

يمكنك الاطّلاع على قائمة بالطُرق والخدمات التي طلبها مشروعك مؤخرًا باستخدام Google Cloud Console:

1. افتح واجهات برمجة التطبيقات والخدمات في Google Cloud Console.
2. انقر على Google Ads API في الجدول.
3. في علامة التبويب الفرعية المقاييس، من المفترض أن تظهر طلباتك الأخيرة على كل رسم بياني. يمكنك الاطّلاع على الطرق التي أرسلت طلبات إليها في جدول الطرق. يتضمّن اسم الطريقة إصدارًا من Google Ads API وخدمة واسم طريقة، مثل google.ads.googleads.v24.services.GoogleAdsService.Mutate.
4. (اختياري) اختَر الفترة الزمنية التي تريد عرض طلباتك فيها.

الاختلافات بين الإيقاف النهائي والإيقاف المؤقت

العبارة	الإيقاف النهائي	الغروب
التعريف	الإصدار القديم هو إصدار ليس الأحدث. بعد إصدار نسخة جديدة، سيتم تصنيف جميع النسخ السابقة على أنّها قديمة.	لم يعُد بالإمكان استخدام الإصدار الذي تم إيقافه. وستتعذّر الطلبات المُرسَلة إلى هذا الإصدار في تاريخ إنهاء العمل به أو بعده.
الآثار	سيظل بإمكانك استخدام الإصدارات المتوقّفة نهائيًا إلى أن يتم إيقافها، ولكن ستتم إزالة التمييز من مراجع الإصدارات المتوقّفة نهائيًا للإشارة إلى أنّها لم تعُد الإصدار الأحدث. ننصحك بالترقية إلى أحدث إصدار في أقرب وقت ممكن للاستفادة من الميزات الجديدة.	عليك الترقية من الإصدارات التي سيتم إيقافها على الفور لكي تتمكّن من استخدام Google Ads API. ننصحك بشدة بالترقية إلى أحدث إصدار باستخدام دليل الترقية.
التوقيت	في المتوسط، نطرح إصدارًا جديدًا كل 3 إلى 4 أشهر، وبالتالي سيتم إيقاف الإصدار المحدّد بعد 3 إلى 4 أشهر تقريبًا.	نهدف إلى إيقاف إصدار بعد عام واحد من إطلاقه.
واجهة برمجة التطبيقات	ستظل نقاط نهاية واجهة برمجة التطبيقات للإصدارات المتوقّفة نهائيًا تعمل كالمعتاد. يمكنك الوصول إلى نقاط نهاية واجهة برمجة التطبيقات باستخدام مكتبات العميل وREST. ومع ذلك، لا تتم إضافة ميزات جديدة إلى الإصدارات المتوقّفة نهائيًا.	تتوقف نقاط نهاية واجهة برمجة التطبيقات للإصدارات التي تم إيقافها نهائيًا عن العمل بعد تواريخ الإيقاف النهائي. ستعرض Google Ads API رسالة خطأ إذا حاولت الوصول إلى نقاط نهاية الإصدارات التي تم إيقافها.
مكتبات العملاء	لأغراض توفير مكتبات عملاء مضغوطة، سنتوقّف عن تضمين إصدارات واجهة برمجة التطبيقات المتوقّفة نهائيًا في إصدار جديد من مكتبة العملاء بعد تاريخ الإيقاف النهائي. يساعدك ذلك في توفير مساحة عند دمج مكتبات البرامج الخاصة بالعملاء في مشاريعك.	لم تعُد مكتبات البرامج المتوافقة مع الإصدارات القديمة من واجهة برمجة التطبيقات تتوافق مع أي إصدارات جديدة من مكتبات البرامج بعد تواريخ إيقافها نهائيًا.
الدعم	نوفّر الدعم بانتظام للإصدارات المتوقّفة نهائيًا.	لم يعُد بالإمكان استخدام الإصدارات التي تم إيقافها بعد تاريخ الإيقاف.

إصدارات مكتبة البرامج المتوافقة

يوضّح الجدول مكتبات البرامج التي تعمل مع إصدارات واجهة برمجة التطبيقات.

إنّ الحدّ الأدنى لإصدار مكتبة البرامج المذكور يكفي لإصدار Google Ads API الرئيسي (مثل الإصدار 24). للاطّلاع على إصدار مكتبة البرامج المطلوب للإصدارات الثانوية، يُرجى الرجوع إلى سجلّ التغيير المرتبط.

إيقاف الميزات نهائيًا وإجراء تغييرات عليها

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

يسرد الجدول التالي عمليات إيقاف الميزات المحدّدة التي تم التخطيط لها في Google Ads API. يمكنك الاطّلاع على مزيد من التفاصيل حول كل عملية إيقاف نهائي في مشاركات المدوّنة المرتبطة.

الميزة	الوصف	تاريخ السريان	ملاحظات إضافية
تغيير سياسة الاحتفاظ بالبيانات	سيتم تقليل فترة التخزين لبيانات التقارير الدقيقة (اليومية والساعية والأسبوعية) إلى 37 شهرًا. تبقى البيانات العامة (الشهرية والربع سنوية والسنوية) متاحة لمدة 11 عامًا. تتوافق فترة الاحتفاظ لمدة 11 عامًا مع حدود الفترة التقويمية الكاملة (بداية الفترة الكاملة التالية). على سبيل المثال: إذا كان تاريخ 22-03-2022 قبل 11 عامًا، سيتم عرض البيانات من 01-04-2022 إلى الوقت الحالي. إذا كان تاريخ 11 عامًا مضت هو 2022-03-01، سيتم عرض البيانات من 2022-04-01 حتى الآن.	‫1 يونيو 2026	يمكنك الاطّلاع على منشور المدوّنة لمزيد من التفاصيل.
تغييرات على إتاحة ميزة "الإحالات الناجحة غير الإلكترونية"	اعتبارًا من 15 يونيو 2026، يجب أن تستخدم رموز المطوّرين التي لم تتضمّن أي طلبات حديثة للإحالات الناجحة غير الإلكترونية واجهة Data Manager API لسير عمل الإحالات الناجحة غير الإلكترونية. إذا أرسل الرمز المميّز للمطوّر طلبًا UploadClickConversions بين 17 ديسمبر 2025 و15 يونيو 2026، يمكنك مواصلة استخدام الرمز المميّز للمطوّر مع Google Ads API لسير عمل الإحالات الناجحة غير الإلكترونية. ومع ذلك، ننصحك بالترقية إلى Data Manager API في سير عمل الإحالات الناجحة غير الإلكترونية للحصول على تجربة أفضل للمطوّرين والاستفادة من ميزات إضافية. وإلا، اعتبارًا من 15 يونيو 2026، ستتعذّر أي طلبات UploadClickConversions وستظهر رسالة الخطأ CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE. استخدِم Data Manager API لمهام العمل المتعلّقة بالإحالات الناجحة غير الإلكترونية بدلاً من Google Ads API.	‫15 يونيو 2026	يمكنك الاطّلاع على منشور المدوّنة لمزيد من التفاصيل.
التغييرات على ميزة "مطابقة العملاء"	اعتبارًا من 1 أبريل 2026، يجب أن تستخدم رموز المطوّرين التي لم تتضمّن طلبات "مطابقة عملاء" حديثة Data Manager API في سير عمل "مطابقة العملاء". إذا أرسل الرمز المميز للمطوّر طلبًا OfflineUserDataJobService أو UserDataService لشرائح جمهور "مطابقة العملاء" بين 1 أكتوبر 2025 و31 مارس 2026، يمكنك مواصلة استخدام الرمز المميز للمطوّر مع Google Ads API لسير عمل "مطابقة العملاء". ومع ذلك، ننصحك بالترقية إلى Data Manager API في سير عمل "مطابقة العملاء" للحصول على تجربة أفضل للمطوّرين والاستفادة من ميزات إضافية. بخلاف ذلك، اعتبارًا من 1 أبريل 2026، ستتعذّر أي طلبات OfflineUserDataJobService أو UserDataService لشرائح جمهور "مطابقة العملاء" وسيظهر الخطأ CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE. استخدِم Data Manager API في سير عمل "مطابقة العملاء" بدلاً من Google Ads API.	‫1 أبريل 2026	يمكنك الاطّلاع على منشور المدوّنة لمزيد من التفاصيل.
التغييرات على توافق بيانات عنوان IP وسمة الجلسة	لم تعُد Google Ads API تقبل أي مستخدمين جدد لسمات الجلسة أو بيانات عنوان IP كجزء من عمليات استيراد الإحالات الناجحة. على المستخدمين الحاليين نقل البيانات إلى Data Manager API.	‫2 فبراير 2026	يمكنك الاطّلاع على منشور المدوّنة لمزيد من التفاصيل.
إيقاف "الإعلانات للاتصال فقط" نهائيًا	لا يمكن إنشاء إعلانات جديدة للاتصال فقط. سيتوقّف عرض "الإعلانات للاتصال فقط" الحالية في فبراير 2027، وستتم إزالة إمكانية استخدام واجهة برمجة التطبيقات. على المعلِنين استخدام "الإعلانات المتجاوبة على شبكة البحث" التي تتضمّن مواد عرض المكالمات بدلاً من ذلك.	يناير 2026	يمكنك الاطّلاع على منشور المدوّنة لمزيد من التفاصيل.