لمحة عن الإصدار 3.0.0 من Google Ads API Developer Assistant

الأربعاء 10 يونيو 2026

يسرّنا الإعلان عن إطلاق الإصدار 3.0.0 من Google Ads API Developer Assistant. يمثّل هذا الإصدار الرئيسي علامة فارقة في تطوّر "مساعد Google"، مع التركيز على تحديث البنية وتحسين الموثوقية وتصميم أكثر مرونة.

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

ما الجديد في الإصدار 3.0.0؟

1. مستند إلى إطار عمل Antigravity

تم نقل Google Ads API Developer Assistant من gemini-cli إلى إطار عمل وكيل Antigravity (الإصدار 3.0.0). توفّر ترقية إطار العمل الأساسي هذا بيئة تنفيذ أكثر تنظيمًا وموثوقية. بالإضافة إلى ذلك، تم تعديل بنية الدليل والملفات في المشروع لتصبح متوافقة بالكامل مع Antigravity.

سينتهي دعم gemini-cli في 18 يونيو 2026، كما هو موضّح في إشعار مدوّنة Google هذا.

2. بنية نموذجية قائمة على المهارات

لقد نقلنا الإمكانات الأساسية في "مساعد Google" إلى المهارات. بدلاً من الاعتماد على تعليمات عامة وغير منظَّمة في ملف سياق، يحمّل "مساعد Google" الآن أدلة أدوات متخصّصة ومختبَرة (المهارات) بشكل ديناميكي عند الحاجة. يؤدي ذلك إلى تقليل "الهلوسة" بشكل كبير ويضمن تنفيذ المهام باستخدام إجراءات دقيقة ومثبَتة.

تشمل التعديلات الرئيسية في هذا الانتقال إلى التصميم الموحّد ما يلي:

  • التحقّق من صحة طلبات GAQL‏ (validate_gaql): تم نقل هذه الميزة إلى مهارة مخصّصة. وتتضمّن الآن عمليات تحقّق محسّنة من طلبات البحث الثابتة لشرائح التاريخ وفلاتر click_view لليوم الواحد وحدود change_status.
  • تحديد المشاكل وحلّها في الإحالات الناجحة (troubleshoot_conversions): يحلّ محلّ conversions_support_package القديم. فهي تدمج جميع النصوص البرمجية والاختبارات المتعلّقة بتحديد المشاكل وحلّها في الإحالات الناجحة وملخّصات التحميل في دليل مهارات واحد متماسك.
  • الأوامر المنظَّمة (explain وstep_by_step): تم تحويلها إلى مهارات لفرض تنسيقات منظَّمة ومتّسقة للتفسيرات.
  • ربط الحسابات الجديدة (get_cids_under_mcc): مهارة جديدة لاسترداد جميع الحسابات الفرعية ضمن حساب إداري (مركز عملائي).
  • فحص العناصر الجديدة (inspect_object): مهارة جديدة للبحث ديناميكيًا عن رسائل Protobuf وEnums بشكل فوري، للمساعدة في ضمان استخدام "مساعد Google" دائمًا للبُنى الصحيحة.
  • فلتر جديد لبيانات "حملات الأداء الأفضل" (pmax_listing_filter): مهارة جديدة لتوحيد تعديلات شجرة استبعاد صفحات الويب لمجموعات البيانات في "حملات الأداء الأفضل".

3- تحسين الاتساق والدقة

لقد وضعنا قواعد ومتطلبات أكثر صرامة للمساعدة في ضمان إنشاء رموز برمجية عالية الجودة والتحقّق من صحة طلبات البحث:

  • تحديد إصدار واجهة برمجة التطبيقات بشكل صريح: تتطلّب المهارات المهمة، مثل get_cids_under_mcc وvalidate_gaql وtroubleshoot_conversions، الآن وسيطة api_version صريحة، ما يزيل أي التباس.
  • قواعد GAQL الصارمة:
    • تمّت إضافة قاعدة إلى AGENTS.md لمنع استخدام دوالّ SQL التجميعية (مثل SUM وCOUNT وAVG) في طلبات GAQL، لأنّها غير متوافقة.
    • تمت إضافة قاعدة للتحقّق من ملاحظات الإصدار في موقع مطوّري Google Ads API أولاً لمعرفة إصدار واجهة برمجة التطبيقات الحالي والتأكّد من أنّ "مساعد Google" يستخدم مستندات محدّثة.
    • إعدادات مبسّطة: تم تبسيط AGENTS.md، ما أدى إلى تقليل قدرة الاستيعاب الأولية. تمت إزالة مستندات الإحالات الناجحة المكرّرة لصالح المهارات الآلية.

4. تحسينات على تجربة المطوّر (DX)

لقد أجرينا العديد من التحسينات على جودة الأداء لجعل عملية التطوير أسرع وأكثر سلاسة:

  • البيئة الافتراضية الدائمة (.venv): لم يعُد يتم حذف البيئة الافتراضية في نهاية الجلسة. عند بدء التشغيل، يتحقّق "مساعد Google" من إصدار Python في نظامك، ولا يعيد إنشاء .venv إلا إذا كان هناك إصدار أحدث من Python.
  • التخزين المؤقت الذكي لإصدار واجهة برمجة التطبيقات: يخزّن "مساعد Google" الآن مؤقتًا الإصدار الحالي من Google Ads API مع مدة صلاحية تبلغ 19 ساعة، ما يقلّل من وقت بدء التشغيل من خلال تجنُّب عمليات التحقّق المتكرّرة من الشبكة.
  • تصحيح الأخطاء بشكل أفضل باستخدام السجلّات الثابتة: تتضمّن الرسائل المسجّلة الآن طوابع زمنية للتاريخ والوقت. تتم كتابة ملف السجلّ في الدليل .agents/ ولم يعُد تتم إعادة ضبطه عند كل عملية تشغيل، ما يحافظ على السجلّ لتحديد المشاكل وحلّها.

ما الفائدة من الترقية؟

تتعلّق الترقية إلى الإصدار 3.0.0 بشكل أساسي بالموثوقية والبنية. من خلال الانتقال إلى إطار عمل Antigravity وتقسيم الميزات إلى مهارات، جعلنا "مساعد Google" أكثر قابلية للتوقّع وأكثر كفاءة في استخدام الموارد.

إذا أردت بدء تشغيل أسرع، وتحقّق أكثر موثوقية من لغة GAQL، وتجربة أكثر فعالية لتحديد المشاكل وحلّها، ننصحك بالترقية إلى الإصدار 3.0.0.

البدء

التثبيت الأول

  1. تثبيت Antigravity CLI: اتّبِع التعليمات على الرابط https://antigravity.google/.
  2. استنساخ المساعد: 
    git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  3. تشغيل نص التثبيت البرمجي:
    • نظام التشغيل Linux/macOS: شغِّل ./install.sh (يتم ضبطه تلقائيًا على دعم Python، واستخدِم علامات مثل --php أو --ruby للغات الأخرى).
    • نظام التشغيل Windows: افتح PowerShell وشغِّل .\install.ps1.

الترقية من الإصدار 2.x

  1. انسخ أي رمز أو بيانات مخصّصة من saved/ إلى موقع آمن خارج دليل المشروع.
  2. احذف النسخة المحلية من "مساعد Google".
  3. استنسِخ المستودع:
git clone https://github.com/googleads/google-ads-api-developer-assistant.git
  1. شغِّل نص التثبيت البرمجي (install.sh أو install.ps1) لبدء بيئة Antigravity الجديدة.

بوب هانكوك، فريق Google Ads API

التصنيفات: google-ads-api، release