مهارات وكيل 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.
- في "الإعدادات":
- انتقِل إلى الإعدادات > التخصيصات.
- ضمن إضافات 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.
يمكن أيضًا استدعاء المهارات يدويًا عن طريق كتابة / في دردشة الوكيل والبحث عن اسم المهارة.
المكوّنات الأساسية للمهارة
كل مهارة وكيل هي حزمة متخصّصة تزوّد المساعد المستند إلى الذكاء الاصطناعي بالمكوّنات التالية:
- تعليمات متخصّصة: تعليمات مفصّلة للطلب يتم إدخالها في نافذة السياق لتوجيه المساعد في إنشاء طلبات بحث بلغة طلبات بحث Google Ads، وإعداد بيانات اعتماد OAuth، والتعامل مع رموز الخطأ الشائعة.
- أفضل الممارسات: توصيات عادية بشأن الأداء والأمان والتكامل يحدّدها فريق علاقات المطوّرين في Google Ads API.
- برامج التشغيل الآلي: برامج تنفيذية (مثل التحقّق من البيئة أو إعداد مساحة العمل) مضمّنة في حِزم المهارات لتنفيذ المهام محليًا.
مزايا استخدام المهارات
توسّع مهارات الوكيل إمكانات المساعد من خلال توفير معلومات متخصّصة عند الطلب بدون الحاجة إلى تحميل تعليمات كبيرة في كل محادثة.
تكاليف أقل للرموز المميّزة
غالبًا ما تحمِّل عمليات التكامل التقليدية المستندة إلى الذكاء الاصطناعي كميات كبيرة من المستندات مسبقًا، ما يستهلك عددًا كبيرًا من الرموز المميّزة ويزيد من تكاليف الجلسة. تستخدم مهارات الوكيل الكشف التدريجي لتقليل هذا العبء:
- في البداية، يتحقّق المساعد المستند إلى الذكاء الاصطناعي فقط من اسم المهارة ووصفها لمعرفة ما إذا كانت مناسبة لطلبك.
- لا تتم إضافة التعليمات والمراجع الكاملة للمهارة إلى نافذة السياق النشطة إلا عندما يحدّد المساعد أنّها ضرورية لمهمتك المحدّدة، ما يؤدي إلى توفير مساحة السياق.
التنفيذ بمساعدة الذكاء الاصطناعي
بدلاً من البحث يدويًا في المستندات، يمكنك وصف هدفك بلغة طبيعية. توجّه المهارات المساعد المستند إلى الذكاء الاصطناعي لتنفيذ مهام مثل ما يلي:
- إنشاء طلب بحث بلغة طلبات بحث Google Ads لاسترداد مقاييس أداء الحملة من حسابي
- كتابة برنامج نصي بلغة Python باستخدام مكتبات برامج العميل لإنشاء حملة جديدة
- استرداد الإحالات الناجحة للحملة والبيانات التشخيصية باستخدام Google Ads API
للاطّلاع على قائمة كاملة بالمهارات المتاحة، يُرجى مراجعة المهارات المتاحة.
استخدام المهارات إلى جانب خادم Google Ads API MCP
تم تصميم مهارات الوكيل لتكمّل خادم Google Ads API Model Context Protocol (MCP):
- خادم Google Ads API MCP: تم تصميمه لمهام سير عمل التطوير بمساعدة الذكاء الاصطناعي، ما يتيح للمساعدين المستندين إلى الذكاء الاصطناعي التفاعل مع موارد Google Ads API، وحملاتك ومقاييسك آليًا.
- مهارات وكيل Google Ads API: توفّر تعليمات للطلب وأفضل الممارسات التي توجّه المساعد لتنفيذ المهام من خلال الكشف التدريجي الفعال من حيث الرموز المميّزة. توجّه هذه المهارات الوكيل بشأن كيفية استخدام أدوات مثل خادم MCP ومكتبات برامج العميل بفعالية.
المهارات المتاحة
يقدّم فريق العمل لواجهة برمجة التطبيقات في Google Ads مجموعة من المهارات التي يمكن استخدامها عند إنشاء تطبيقات باستخدام Google Ads API:
| المهارة | الوصف |
|---|---|
google-ads-api-account-diagnostics |
تشخيص مشاكل أداء حساب "إعلانات Google"، مثل فقدان الإحالات الناجحة وانخفاض عدد العملاء المحتملين وفقدان حصة الظهور بسبب ترتيب الإعلان أو عروض الأسعار أو الميزانيات، باستخدام خادم Google Ads API MCP. |
google-ads-api-mcp-setup |
المساعدة في إعداد خادم Model Context Protocol (MCP) في Google Ads API وضبطه، ما يسهّل عملية المصادقة والإعداد في البيئات المحلية. |
google-ads-api-quickstart |
توجيهك خلال عملية إعداد بيئة المطوّرين وضبط بيانات الاعتماد وإجراء أول طلب بيانات من Google Ads API. |