Google Ads API · Reporting
Google Ads API v21 سيتوقف في 5 أغسطس 2026: لا تنتظر يوم التعطل.
Google أعلنت أن كل طلبات Google Ads API v21 ستبدأ في الفشل من 5 أغسطس 2026. أي لوحة تقارير، سكريبت إدارة حملات، أو تكامل داخلي ما زال على v21 يحتاج خطة ترقية واضحة قبل هذا التاريخ.
الموعد الفني هو 5 أغسطس، لكن الموعد التشغيلي الأفضل هو قبل ذلك بأسبوعين على الأقل حتى يوجد وقت للاختبار وتصحيح الاستعلامات التي تغيرت.
لماذا هذا مهم؟
توقف إصدار API لا يعني بطءًا مؤقتًا؛ يعني أن الطلبات المبنية على هذا الإصدار ستفشل. التأثير قد يظهر في تقارير Looker، مزامنة التكلفة والتحويلات، أدوات مراقبة الميزانية، أو أي سكريبتات تعدل الحملات بشكل دوري.
ما الذي يجب مراجعته؟
- كل التطبيقات التي تستخدم Google Ads API مباشرة أو عبر connector مخصص.
- استعلامات GAQL التي تعتمد على fields أو resources تغيرت في الإصدارات الأحدث.
- تقارير Performance Max وShopping وSearch التي تسحب بيانات يومية.
- أي automation يضيف حملات أو يعدل budgets أو يوقف عناصر بناءً على rules.
- سجلات الأخطاء في آخر 30 يوم لمعرفة التطبيقات التي ما زالت نشطة.
خطة ترقية مختصرة
ابدأ بحصر كل مصادر API، ثم اختبر إصدارًا أحدث في بيئة محدودة قبل تغيير الإنتاج. لا تكتف بتغيير رقم الإصدار؛ راجع نتائج التقارير قبل وبعد الترقية، لأن بعض المقاييس أو التقسيمات قد تتطلب تعديلًا في الاستعلام.
مؤشرات الخطر
- وجود reports تعمل بدون مالك واضح.
- اعتماد dashboard يومي على job واحد لا يملك fallback.
- عدم وجود تنبيه عند فشل مزامنة Google Ads.
- وجود أكثر من MCC أو connector يستخدم إعدادات مختلفة.
مصادر مفيدة
هل تقارير Google Ads عندك جاهزة؟
نراجع إصدارات API، لوحات التقارير، وأماكن الفشل المحتملة قبل توقف الإصدار.
اطلب مراجعة Google Ads API