الخميس 26 فبراير 2026
يؤدي هذا التحديث الرئيسي إلى تحويل المساعد من أداة فعّالة لإنشاء الرموز البرمجية إلى شريك استباقي في تحديد المشاكل وحلّها والتشغيل الآلي لمطوّري "إعلانات Google". منذ إطلاق الإصدار 1.6.0، استمعنا إلى ملاحظاتكم وركّزنا على الجوانب الأكثر صعوبة في تطوير واجهة برمجة التطبيقات: التشخيص والاتساق والإعداد.
ما هي الميزات الجديدة في الإصدار 2.0؟
1. تثبيت وصيانة أسهل
لا ينبغي أن يكون إعداد بيئة تطوير متعددة اللغات مهمة صعبة.
- الإعداد بأمر واحد: استخدِم علامة
--install-depsالجديدة معinstall.shأوinstall.ps1للتعامل مع تبعيات pip وcomposer وbundler دفعة واحدة. - بنية الدليل الموحّدة: يتم الآن تنظيم جميع الرموز البرمجية التي تم إنشاؤها وعمليات تصدير ملفات CSV والتقارير التشخيصية ضمن دليل
saved/واحد مع أدلة فرعية لكل نوع من أنواع النتائج. - التحديث بأمر واحد: عند إصدار نسخة جديدة من واجهة برمجة التطبيقات ومكتبات البرامج، عليك تنفيذ
update.shللعمل مع أحدث إصدار. يمكنك أيضًا استخدامupdate.shلإضافة مكتبات عملاء إضافية إلى السياق.
2. تحديد المشاكل وحلّها في الإحالات الناجحة المستندة إلى الذكاء الاصطناعي الوكيل
تُعدّ ميزة تتبُّع الإحالات الناجحة غير الإلكترونية إحدى أقوى ميزات Google Ads API، ولكنّها معقّدة. قد تستغرق عملية تصحيح الأخطاء لمعرفة سبب عدم تحديد مصدر الإحالة الناجحة وقتًا طويلاً.
في الإصدار 2.0، قدّمنا حزمة مخصّصة لتحديد المشاكل وحلّها في الإحالات الناجحة وبيانات التشخيص.
- النص البرمجي الجديد:
api_examples/collect_conversions_troubleshooting_data.py - الطلب الجديد:
/conversions_support_data
ينفّذ النص البرمجي تقارير عادية لتحديد المشاكل وحلّها في الإحالات الناجحة، ويقدّم سياقًا لـ "مساعد Google" من أجل تحديد المشاكل وحلّها.
يكون هذا الطلب مفيدًا للغاية بعد أن يحلّل "مساعد Google" مشكلة الإحالة الناجحة ويحاول حلّها. إذا لم يتمكّن من ذلك، وكنت بحاجة إلى التواصل مع فريق الدعم، سيحلّل هذا الأمر إعدادات العميل وإجراءات الإحالات الناجحة وملخّصات التحميل لإنشاء تقرير تشخيصي منظَّم استنادًا إلى التحليل الذي تم إجراؤه. ويمكنها أيضًا تحديد الحالات "غير السليمة" ومعدّلات الفشل المرتفعة تلقائيًا، ما يوفّر عليك ساعات من البحث في السجلّات. ويحفظ النتائج في ملف نصي يمكنك تضمينه مع طلب الدعم إذا كنت بحاجة إلى تقديم طلب.
3- تم إنشاؤه لأحدث واجهة برمجة تطبيقات (الإصدار 23)
يتوافق الإصدار 2.0 بالكامل مع الإصدار 23 من Google Ads API. تم تعديل جميع الأمثلة التفاعلية، وتم تحسين السياق الداخلي لـ Assistant ليتوافق مع أحدث المراجع والحقول، ما يضمن أنّ الرمز الذي تنشئه جاهز للاستخدام في الإنتاج.
4. التشغيل الآلي السلس باستخدام Session Hooks
لقد أضفنا خطافات SessionStart وSessionEnd لجعل سير العمل سلسًا تمامًا.
- الإعداد التلقائي: يمكن لـ Assistant الآن تحديد موقع ملف الإعداد تلقائيًا في دليل
$HOMEفي بداية الجلسة. ويتم نسخه إلى دليل الضبط الفرعي في دليل مشروعك. Python هي لغة Gemini المفضّلة لإرسال طلبات البحث إلى واجهة برمجة التطبيقات. لذلك، إذا كنت تستخدم لغة أخرى، يقرأ ملف الإعداد وينشئ ملف google-ads.yaml مؤقتًا في config لطلبات البحث، ولكنه يواصل الردّ في رمز لغتك المفضّلة. - التنظيف التلقائي: يتم محو الإعدادات المؤقتة بأمان عند الخروج، ما يحافظ على نظافة مساحة العمل وأمان بيانات الاعتماد.
5- التحقّق من صحة طلبات GAQL بشكل أكثر ذكاءً
أصبح إنشاء طلبات بحث GAQL المعقّدة أسهل من أي وقت مضى. لقد عدّلنا GEMINI.md وconversions/GEMINI.md باستخدام قواعد تحقّق صارمة لأحدث الحالات الاستثنائية في واجهة برمجة التطبيقات، بما في ذلك تحسين معالجة شرائح التاريخ ومتطلبات النطاق المحدود. يكتشف "مساعد Gemini" الآن الأخطاء المنطقية قبل تنفيذ طلب البحث.
6. المهارات
يمكنك اعتبار "المهارة" مكوّنًا إضافيًا صغيرًا أو "مخططًا للسلوك". على الرغم من أنّ السياق العام (مثل ملف GEMINI.md) يوفّر معلومات أساسية، لا يتم "تحميل" المهارة في عقل الذكاء الاصطناعي إلا عندما يحتاج تحديدًا إلى تنفيذ مهمة إجرائية معقّدة، مثل الحصول على الإصدار الحالي من هذه الإضافة. لا يمكنك تنفيذ المهارة مباشرةً. ويقرّر Gemini متى يحتاج إلى ذلك.
على الرغم من أنّ هذه الميزة لا تزال تجريبية، فقد أضفنا ميزة واحدة في هذا الإصدار لتكملة استخدامنا للخطافات لبدء الجلسة وتنظيفها.
لماذا ننصح بالترقية؟
لا تقتصر النقلة من الإصدار 1.6.0 إلى الإصدار 2.0.0 على الميزات الجديدة فحسب، بل تتعلّق أيضًا بالموثوقية. من خلال دمج المعرفة العميقة بواجهة برمجة التطبيقات مع أدوات التشخيص المبرمَجة، يقلّل الإصدار 2.0 من حلقة "التجربة والخطأ" التي غالبًا ما تؤدي إلى إبطاء عملية دمج واجهة برمجة التطبيقات.
سواء كنت بصدد تصحيح أخطاء عمليات تحميل الإحالات الناجحة أو إنشاء مسارات معقّدة لإعداد التقارير، يمنحك الإصدار 2.0 الأدوات اللازمة للعمل بشكل أسرع وبثقة أكبر.
البدء
التثبيت الأول
git clone https://github.com/googleads/google-ads-api-developer-assistant.git- في دليل المشروع، شغِّل install.sh أو install.ps1 لتثبيت الإضافة ومكتبات البرامج.
الترقية من إصدار سابق
- انسخ أي رمز مخصّص من
saved_code/وsaved_csv/إلى مكان آمن. - احذف النسخة المحلية من Google Ads API Developer Assistant من خلال حذف دليل المشروع وجميع الأدلة الفرعية والملفات.
git clone https://github.com/googleads/google-ads-api-developer-assistant.git- في دليل المشروع، شغِّل install.sh أو
install.ps1لتثبيت الإضافة ومكتبات البرامج.
التصنيفات: google-ads-api، release