قبل ترقية الكود، اعرف أي services وmethods ما زالت ترسل طلبات v21 فعلًا.

نُشر في 1 أغسطس 2026 · Google Ads API v21 / Method Inventory / Migration QA

ذكرت Google Ads Developer Blog أن كل طلبات Google Ads API v21 ستبدأ في الفشل من 5 أغسطس 2026. النقطة العملية في الأيام الأخيرة قبل الموعد ليست قراءة release notes فقط، بل معرفة أين ما زالت v21 مستخدمة داخل أدواتك. Google توضح أن Cloud Console يعرض methods التي أرسلها المشروع مؤخرًا، مع اسم النسخة والخدمة والطريقة.

لماذا الجرد مهم؟

في الوكالات، قد يوجد أكثر من connector أو script أو dashboard يستخدم نفس مشروع Google Cloud. إذا ركزت على ملف واحد، قد تترك مسارًا قديمًا يتعطل يوم الإيقاف.

جرد methods يكشف الخدمات المستخدمة فعليًا: SearchStream، Mutate، تقارير conversions، أو إدارة user access. بعد ذلك يصبح اختبار الترقية محددًا بدل مراجعة عامة لكل API.

كيف تحول الجرد إلى خطة؟

اصنع قائمة بكل method يظهر باسم v21. ضع أمام كل واحد مالك النظام، نوع الأثر، وبيئة الاختبار. ابدأ بالمسارات التي توقف التقارير اليومية أو تنفيذ تغييرات الحساب.

بعد الترقية، قارن عينة نتائج قبل وبعد، خصوصًا في Performance Max وDemand Gen وconversion reporting. اختلاف القياس يحتاج توثيقًا حتى لا يقرأه فريق الأداء كتحسن أو تراجع حقيقي.

Checklist قبل 5 أغسطس

• افتح Google Cloud Console لمشروع API.
• راجع Google Ads API Metrics ثم Methods.
• استخرج كل method يحتوي على v21.
• اربط كل method بنظام أو dashboard معروف.
• اختبر أحدث نسخة على عينة حسابات محدودة.
• اكتب تاريخ الترقية داخل سجل التقارير.

أين تدخل ok4host؟

ok4host يراجع تكامل Google Ads API من زاوية التشغيل: أين توجد النسخ القديمة، ما أثر كل method، وكيف يتم التحقق من التقارير بعد الترقية.

أسئلة شائعة

هل توقف v21 يعني توقف الحسابات؟ لا، لكنه يعني فشل طلبات API التي تستخدم v21.

هل يكفي تحديث client library؟ ليس دائمًا؛ يجب اختبار الاستعلامات والحقول والمسارات.

ما أول تقرير أراجعه؟ أي تقرير يومي تعتمد عليه قرارات الميزانية.

المصادر

• Google Ads Developer Blog: v21 sunset reminder.
• Google Ads API: Release notes.
• Google Ads API: Productionize your app.