مهارات وكيل Google Ads API

مهارات وكيل Google Ads API هي وحدات مستقلة وقابلة للنقل تتضمّن معلومات وتعليمات وسير عمل خاصة بـ Google Ads API. تعمل مهارات وكيل Google Ads API مع المساعدين المستندين إلى الذكاء الاصطناعي الذين يتوافقون مع معيار Agent Skills المفتوح، بما في ذلك Google Antigravity وClaude Code.

تم تصميم مهارات الوكيل هذه لمساعدة المساعدين المستندين إلى الذكاء الاصطناعي في فهم أفضل الممارسات المتعلّقة بواجهة Google Ads API، وضبط الأدوات، وتنفيذ مهام سير العمل بدقة أعلى وتكلفة أقل للرموز المميّزة. للاطّلاع على قائمة بالمهارات المتاحة، يُرجى مراجعة المهارات المتاحة.

البدء

ثبِّت مهارات الوكيل المناسبة لبيئة التطوير لديك.

تثبيت مهارات وكيل Google Ads API

في معظم الحالات، يمكن تثبيت مهارات وكيل Google Ads API في المحرّر المفضّل لديك باستخدام أمر واحد:

Antigravity

تُعدّ مهارات وكيل Google Ads API من ضمن حِزم دمج Build with Google في Antigravity. يمكنك تفعيل هذه الحزمة للوصول على المستوى العام في نقطتين:

  • أثناء عملية الإعداد: ضَع علامة في مربّع الاختيار الخاص بمجموعة Google Ads API.
  • في "الإعدادات":
    1. انتقِل إلى الإعدادات > التخصيصات.
    2. ضِمن إضافات Build with Google، انقر على تخصيص، ثم انقر على تنزيل لدمج Google Ads API.

إذا كنت تفضّل الوصول على مستوى المشروع، نفِّذ الأمر التالي في دليل مشروعك:

npx skills add google/skills/skills/ads --agent=antigravity

Claude Code 

npx skills add google/skills/skills/ads --agent=claude-code

Codex 

npx skills add google/skills/skills/ads --agent=codex

المؤشر

يمكنك تثبيت مهارات وكيل Google Ads API مباشرةً من خلال إضافة نقطة نهاية مستودع GitHub الخاص بالمهارة (مثلاً، https://github.com/google/skills) في إعدادات المحرّر ضمن القواعد المخصّصة. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Cursor حول تثبيت المهارات من GitHub.

يمكنك أيضًا تثبيت المهارات باستخدام npx (يتطلب Node.js):

npx skills add google/skills/skills/ads --agent=cursor

وكلاء آخرون

بالنسبة إلى المساعدين الآخرين المستندين إلى الذكاء الاصطناعي والذين يتوافقون مع معيار Agent Skills المفتوح، يمكنك تثبيت المهارات باستخدام npx (يتطلّب Node.js):

npx skills add google/skills/skills/ads

تعديل مهارات وكيل Google Ads API

يمكنك الحصول على جميع التحديثات المتاحة وإزالة المهارات القديمة من خلال تشغيل الأمر update:

Antigravity

تتم إدارة عمليات الدمج المفعَّلة من خلال Build with Google وتحديثها تلقائيًا بواسطة المحرِّر.

إذا ثبّت مهارات الوكيل باستخدام الأمر npx، يمكنك الحصول على جميع التحديثات المتاحة من خلال تشغيل الأمر update:

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

المؤشر 

npx skills update --all

وكلاء آخرون

بالنسبة إلى المساعدين الآخرين المستندين إلى الذكاء الاصطناعي والذين يتوافقون مع معيار Agent Skills المفتوح، يمكنك تحديث جميع المهارات النشطة باستخدام npx:

npx skills update --all

استخدام مهارات وكيل Google Ads API

تم تصميم المساعدين المستنِدين إلى الذكاء الاصطناعي لاستخدام المهارات تلقائيًا عندما يكتشفون أنّ وصف المهارة يتطابق مع طلبك الحالي. تبقى المهارات المثبّتة على مستوى العالم غير نشطة في المشاريع غير ذات الصلة ما لم يتطابق سياق طلبك مع مهام Google Ads API.

يمكن أيضًا استدعاء المهارات يدويًا من خلال كتابة / في محادثة الوكيل والبحث عن اسم المهارة.

المكوّنات الأساسية للمهارة

كل مهارة للوكيل هي حزمة متخصّصة تزوّد المساعد المستنِد إلى الذكاء الاصطناعي بالمكوّنات التالية:

  • تعليمات متخصّصة: تعليمات مفصّلة للطلبات يتم إدخالها في نافذة السياق لتوجيه المساعد في إنشاء طلبات GAQL وضبط بيانات اعتماد OAuth ومعالجة رموز الخطأ الشائعة.
  • أفضل الممارسات: هي اقتراحات عادية بشأن الأداء والأمان والدمج يحدّدها فريق علاقات المطوّرين في Google Ads API.
  • نصوص برمجية مبرمَجة: نصوص برمجية قابلة للتنفيذ (مثل تلك المخصّصة للتحقّق من صحة البيئة أو إعداد مساحة العمل) مضمّنة في حِزم المهارات لتنفيذ المهام محليًا

مزايا استخدام المهارات

توسّع مهارات الوكيل إمكانات المساعد من خلال المعرفة المتخصّصة عند الطلب بدون الحاجة إلى تحميل تعليمات ضخمة في كل محادثة.

تكاليف الرموز المميّزة المخفّضة

غالبًا ما تحمّل عمليات دمج الذكاء الاصطناعي التقليدية كميات هائلة من المستندات مسبقًا، ما يستهلك عددًا كبيرًا من الرموز المميّزة ويزيد من تكاليف الجلسات. تستخدم مهارات الوكيل الإفصاح التدريجي لتقليل هذا العبء:

  • يتحقّق المساعد المستنِد إلى الذكاء الاصطناعي في البداية من اسم المهارة ووصفها فقط لمعرفة ما إذا كانت مناسبة لطلبك.
  • لا تتم إضافة التعليمات والمراجع الكاملة للمهارة إلى نافذة السياق النشطة إلا عندما يحدّد المساعد أنّها ضرورية لمهمتك المحدّدة، ما يوفّر مساحة في السياق.

تنفيذ موجَّه بالذكاء الاصطناعي

بدلاً من البحث يدويًا في المستندات، يمكنك وصف نيتك بلغة طبيعية. توجّه المهارات مساعدك المستنِد إلى الذكاء الاصطناعي لتنفيذ مهام مثل:

  • أريد إنشاء طلب بحث بلغة GAQL لاسترداد مقاييس أداء الحملات من حسابي.
  • اكتب نصًا برمجيًا بلغة Python باستخدام مكتبات العملاء لإنشاء حملة جديدة.
  • استرداد الإحالات الناجحة للحملات وبيانات التشخيص باستخدام Google Ads API

للحصول على قائمة كاملة بالمهارات المتاحة، يُرجى الاطّلاع على المهارات المتاحة.

استخدام المهارات مع خادم MCP في Google Ads API

تم تصميم مهارات الوكيل لتتكامل مع خادم بروتوكول سياق النموذج (MCP) في Google Ads API:

  • خادم MCP في Google Ads API: تم تصميمه لسير عمل التطوير بمساعدة الذكاء الاصطناعي، ما يتيح للمساعدين المستندين إلى الذكاء الاصطناعي التفاعل مع موارد Google Ads API والحملات والمقاييس آليًا.
  • مهارات وكيل Google Ads API: يمكنك تقديم تعليمات فورية وأفضل الممارسات المقترَحة التي توجّه المساعد لتنفيذ المهام من خلال الإفصاح التدريجي الفعّال عن الرموز المميّزة. وهي توجّه الوكيل حول كيفية استخدام أدوات مثل خادم MCP ومكتبات العملاء بفعالية.

المهارات المتاحة

يوفّر فريق العمل لواجهة برمجة التطبيقات في Google Ads مجموعة من المهارات لإنشاء التطبيقات باستخدام Google Ads API:

المهارة الوصف
google-ads-api-account-diagnostics تشخيص مشاكل الأداء في حساب "إعلانات Google"، مثل فقدان الإحالات الناجحة، وانخفاض عدد العملاء المحتملين، ونسبة ظهور الإعلان المفقودة بسبب ترتيب الإعلان أو عروض الأسعار أو الميزانيات، وذلك باستخدام خادم MCP في Google Ads API
google-ads-api-mcp-setup يساعد في إعداد خادم Model Context Protocol (MCP) الخاص بواجهة Google Ads API وضبطه، ما يسهّل عملية المصادقة والإعداد في البيئات المحلية.
google-ads-api-quickstart يوجّهك هذا الدليل خلال عملية إعداد بيئة المطوّر وضبط بيانات الاعتماد وإجراء أول طلب بيانات من Google Ads API.

الخطوات التالية