الأربعاء 10 ديسمبر 2025
نعلن عن إطلاق Google Ads API Developer Assistant، وهي إضافة فعّالة لـ Gemini CLI مصمّمة لتبسيط سير عمل Google Ads API. تتيح لك هذه الأداة التفاعل مع Google Ads API باستخدام لغة يومية، ما يسهّل عليك أكثر من أي وقت مضى الحصول على المعلومات وإنشاء الرموز البرمجية وحتى استرداد البيانات مباشرةً في وحدة التحكّم.
سواء كنت مبتدئًا في استخدام Google Ads API أو مطوّرًا متمرسًا، يمكن أن يساعدك هذا المساعد في العمل بكفاءة أكبر.
استخداماتها
يُحسّن Google Ads API Developer Assistant (الإصدار 1.0) من Gemini CLI من خلال عدة ميزات رئيسية:
- أسئلة وأجوبة بلغة طبيعية: هل لديك أسئلة حول Google Ads API؟ ما عليك سوى طرح سؤال.
- "ما هي أنواع الحملات المتاحة؟"
- "أريد معرفة المزيد عن إعداد التقارير في "حملات الأداء الأفضل"."
- "كيف يمكنني الفلترة حسب التاريخ في GAQL؟"
- تحويل اللغة الطبيعية إلى رمز برمجي: يمكنك وصف البيانات التي تحتاجها، وسينشئ المساعد لغة طلب البحث في "إعلانات Google" (GAQL) ورمز Python البرمجي القابل للتنفيذ باستخدام مكتبة عملاء
google-ads-pythonكسياق ليتوافق الرمز مع أفضل الممارسات.- "اعرِض لي الحملات التي حقّقت أكبر عدد من الإحالات الناجحة في آخر 30 يومًا".
- "Get all ad groups for customer '123-456-7890'."
- "العثور على الإعلانات المرفوضة في جميع الحملات"
- يتم حفظ الرمز الذي تم إنشاؤه تلقائيًا في الدليل
saved_code/.
- تنفيذ واجهة برمجة التطبيقات مباشرةً: يمكنك تشغيل نصوص Python البرمجية التي تم إنشاؤها مباشرةً من سطر الأوامر. سينفّذ المساعد طلبات البيانات من واجهة برمجة التطبيقات التي تمنح إذنًا بالقراءة فقط ويعرض النتائج، وغالبًا ما يتم تنسيقها بدقة كجداول داخل الوحدة الطرفية.
- تصدير ملف CSV: هل تريد حفظ بياناتك؟ يمكنك بسهولة تصدير النتائج المجدولة من طلبات البيانات من واجهة برمجة التطبيقات إلى ملف CSV. ما عليك سوى طرح السؤال التالي:
- "أريد حفظ النتائج في ملف CSV"
- يتم حفظ الملفات في الدليل
saved_csv/.
كيف تعمل هذه الميزة؟
تستفيد هذه الإضافة من قدرة Gemini CLI على استخدام السياق من ملفات وإعدادات GEMINI.md ضمن .gemini/settings.json. من خلال ضبط المساعد باستخدام مسارات إلى نسخة مكتبة google-ads-python المحلية وأدلة الأمثلة، يوفّر المساعد إنشاء رموز برمجية ذات صلة ودقيقة.
البدء
إليك ما تحتاج إليه لبدء الاستخدام:
المتطلبات الأساسية:
- الإلمام بمفاهيم Google Ads API والمصادقة
- رمز مميّز للمطوّر في Google Ads API
- ملف بيانات اعتماد
google-ads.yamlتم ضبطه في الدليل الرئيسي - Python >= 3.10
- تثبيت Gemini CLI
- نسخة محلية من مكتبة برامج
google-ads-python(يمكن لنص التهيئة البرمجي استنساخ هذا المستودع نيابةً عنك).
يُرجى الرجوع إلى ملف README في مستودع GitHub للحصول على تعليمات وأمثلة مفصّلة حول الإعداد.
أين يمكن العثور عليها؟
يتوفّر Google Ads API Developer Assistant على GitHub.
المنتدى والدعم
ننصحك بتجربتها. ملاحظاتك تهمّنا ويمكنك تقديمها في هذا الاستطلاع. يمكنك الانضمام إلى المناقشة في قناة #ads-api-ai-tools على Discord.
يُرجى استخدام علامة التبويب "المشاكل" (Issues) في GitHub ضمن المستودع للإبلاغ عن الأخطاء أو اقتراح ميزات أو طلب الدعم. يمكنك الاطّلاع على CONTRIBUTING.md لمعرفة إرشادات المساهمة.
استمتِع بالترميز!
التصنيفات: google-ads-api، release