مهارات وكيل Google Ads API هي وحدات مستقلة وقابلة للنقل تتضمّن معرفة وتعليمات ومهام سير عمل خاصة بواجهة Google Ads API. تعمل مهارات الوكيل في Google Ads API مع مساعدات الذكاء الاصطناعي التي تتوافق مع معيار مهارات الوكيل المفتوح، بما في ذلك Google Antigravity وClaude Code.
تم تصميم مهارات الوكيل هذه لمساعدة مساعدات الذكاء الاصطناعي في فهم أفضل الممارسات المتعلّقة بواجهة Google Ads API، وإعداد الأدوات، وتنفيذ مهام سير العمل بدقة أعلى وتكلفة أقل للرموز المميزة. للاطّلاع على قائمة بالمهارات المتاحة، يُرجى الانتقال إلى المهارات المتاحة.
البدء
ثبِّت مهارات الوكيل المناسبة لبيئة التطوير.
تثبيت مهارات وكيل Google Ads API
في معظم الحالات، يمكن تثبيت مهارات وكيل Google Ads API في المحرّر المفضّل لديك باستخدام أمر واحد:
Antigravity
يتم تضمين مهارات وكيل Google Ads API كإحدى حِزم الدمج ضمن Build with Google في Antigravity. يمكنك تفعيل هذه الحزمة للوصول على مستوى العالم في نقطتَين:
- أثناء عملية الإعداد: ضَع علامة في مربّع الاختيار الخاص بحزمة Google Ads API.
- في "الإعدادات":
- انتقِل إلى الإعدادات > التخصيصات.
- ضمن إنشاء باستخدام مكوّنات Google الإضافية، انقر على تخصيص، ثم انقر على تنزيل لدمج Google Ads API.
إذا كنت تفضّل الوصول على مستوى المشروع، نفِّذ الأمر التالي في دليل مشروعك:
npx skills add google/skills --agent=antigravity
Claude Code
claude plugin marketplace add google/skills
claude plugin install google-ads@skills
Codex
npx skills add google/skills
المؤشر
يمكنك تثبيت مهارات وكيل Google Ads API مباشرةً من خلال إضافة نقطة نهاية مستودع GitHub الخاص بالمهارة (على سبيل المثال، https://github.com/google/skills) في إعدادات المحرّر ضمن القواعد المخصّصة. لمزيد من التفاصيل، يُرجى الاطّلاع على
مستندات قواعد المؤشر.
الوكلاء الآخرون
بالنسبة إلى المساعدين الآخرين المستندين إلى الذكاء الاصطناعي والمتوافقين مع معيار Agent Skills المفتوح، يمكنك تثبيت المهارات باستخدام NPX:
npx skills add google/skills
تعديل مهارات وكيل Google Ads API
يمكنك الحصول على جميع التحديثات المتاحة وإزالة المهارات القديمة من خلال تنفيذ الأمر update:
Antigravity
تتم إدارة عمليات الدمج المفعَّلة من خلال Build with Google وتحديثها تلقائيًا بواسطة المحرّر.
إذا ثبّت مهارات الوكيل باستخدام الأمر npx، يمكنك الحصول على جميع التحديثات المتاحة من خلال تنفيذ الأمر update:
npx skills update --all
Claude Code
claude plugin update google-ads@skills
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.
- نصوص برمجية لتنفيذ المهام آليًا: نصوص برمجية قابلة للتنفيذ (مثل التحقّق من صحة البيئة أو إعداد مساحة العمل) مضمّنة في حِزم المهارات لتنفيذ المهام محليًا.
مزايا استخدام المهارات
توسّع مهارات الوكيل إمكانات المساعد من خلال توفير معرفة متخصّصة عند الطلب بدون الحاجة إلى تحميل تعليمات ضخمة في كل محادثة.
تكاليف الرموز المميزة المخفَّضة
غالبًا ما تؤدي عمليات دمج الذكاء الاصطناعي التقليدية إلى تحميل كميات هائلة من المستندات مسبقًا، ما يؤدي إلى استهلاك عدد كبير من الرموز المميزة وزيادة تكاليف الجلسة. تستخدم مهارات الوكيل الكشف التدريجي لتقليل هذا الحمل الزائد:
- يتحقّق مساعد الذكاء الاصطناعي في البداية من اسم المهارة ووصفها فقط لمعرفة ما إذا كانت مرتبطة بطلبك.
- لا تتم إضافة التعليمات والمراجع الكاملة للمهارة إلى قدرة الاستيعاب النشطة إلا عندما يحدّد "مساعد Google" أنّها ضرورية لمهمتك المحدّدة، ما يؤدي إلى توفير مساحة السياق.
التنفيذ الموجّه بالذكاء الاصطناعي
بدلاً من البحث يدويًا في المستندات، يمكنك وصف نيتك بلغة طبيعية. توجّه المهارات مساعدك المستند إلى الذكاء الاصطناعي لتنفيذ مهام مثل ما يلي:
- إنشاء طلب بحث 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 API مجموعة من المهارات اللازمة للاستفادة من Google Ads API:
| المهارة | الوصف |
|---|---|
google-ads-api-mcp-setup |
تساعد هذه الأداة في إعداد خادم بروتوكول سياق النموذج (MCP) الخاص بواجهة Google Ads API وضبط إعداداته، ما يسهّل عملية المصادقة والإعداد في البيئات المحلية. |
google-ads-api-quickstart |
يقدّم لك إرشادات حول إعداد بيئة المطوّرين وإعداد بيانات الاعتماد وإجراء أول طلب بيانات من Google Ads API. |