سرد حسابات Google Ads هي GET على /google-ads/v1/accounts، ضمن Top-Rated Team Google Ads API: حسابات Google Ads التي أُسندت إلى مؤسستك. كل طلب يحمل مفتاحك أنت في ترويسة X-API-KEY — وهو المفتاح نفسه الذي تستخدمه مع LinkedIn API — ولا يصل إلا إلى الحسابات التي أُسندت إلى مؤسستك. أما الحساب الذي لم يُسنده إليها أحد فيُجاب عنه كأنه غير موجود.
لا شيء هنا يغيّر حسابًا من تلقاء نفسه. يُقترح التغيير، وتفحصه Google ويُدوَّن، ولا يُنفَّذ إلا حين يطبّقه شخص — مع تدوين ما يلزم للتراجع عنه أولًا، حتى يمكن إعادة الحساب إلى حاله.
الطلب
curl -X GET "https://top-rated.team/google-ads/v1/accounts" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
ما يعود حين لا تنجح
- 401 — المفتاح ناقص أو خاطئ أو مُلغى.
- 402 — الخطة غير مدفوعة. تجيب خدمة Top-Rated Team API بهذا بعد انتهاء التجربة.
- 404 — إما أن الشيء غير موجود، وإما أنه ليس لمؤسستك. الجوابان متطابقان عن قصد، حتى لا تُستكشَف المعرّفات.
- 429 — طلبات أكثر من اللازم، أو أن المنصة تطلب منا التمهّل. انتظر قليلًا قبل أن تحاول مجددًا.
- 502 أو 503 — لم تجب المنصة الآن. حاول مجددًا بعد قليل.
كل خطأ هو JSON بالشكل نفسه: {"type":"errors/<code>","status":<n>,"detail":"..."} — فمعالج واحد يغطيها جميعًا، وحقل detail مكتوب ليُعرض على إنسان.
اطلبها من مساعد بدلًا من ذلك
هذه العملية أداة MCP أيضًا. الصق https://top-rated.team/google-ads/mcp/<your API key> في Claude أو ChatGPT أو أي مساعد يتكلم MCP، واطلب ما تريد بلغة عادية — فيختار المساعد الاستدعاء، ويملأ المعرّفات، ويقرأ لك الجواب. والوكيل الشامل على https://top-rated.team/mcp/<your API key> يملكها أيضًا، إلى جانب LinkedIn API وكل قناة أخرى.
في غرفة مشروع
في غرفة مشروع، حدِّد وكيل هذه الواجهة تحت «يمكنه استخدام» لوكيل ذكاء اصطناعي خاص بك، فيستدعي «سرد حسابات Google Ads» أداةً كلما احتاجت المحادثة إلى ذلك. ويرى كل من في الغرفة ما طلبه وما عاد به. اسأل بكلمات عادية؛ واسم الوكيل هنا @scout:
- @scout ما الذي أهدر أكثر مال في عبارات البحث لدينا الأسبوع الماضي؟ واكتب الكلمات الاستبعادية كاقتراح يقرؤه أحدهم قبل أن يُنفَّذ.
أسئلة شائعة
هل يستطيع وكيل ذكاء اصطناعي أن يستدعي «سرد حسابات Google Ads» نيابةً عني؟
نعم. يستطيع ذلك أي مساعد يتكلم MCP، عبر العنوان أعلاه، ويستطيعه كذلك وكيل ذكاء اصطناعي خاص بك في غرفة مشروع حُدِّد له وكيل هذه الواجهة. أما الوكلاء المدمجون في الغرفة فلا يستطيعون: فهم ينصحون ولا يحملون مفتاحك.
هل يعمل خارج الغرفة، من كودي أنا؟
نعم. الطلب أعلاه هو العملية نفسها التي تستدعيها أدوات وكيل الذكاء الاصطناعي، بالجواب نفسه وبالأخطاء نفسها. ومفتاحك يصل إلى القنوات نفسها أيًّا كانت الطريقة التي تدخل بها.
هل يعمل في غرفة بعلامتي التجارية؟
نعم. على عنوان العلامة البيضاء تحمل الواجهة ومرجعها ووكيل الذكاء الاصطناعي فيها اسم منتجك، وتصل إلى القنوات نفسها بالقواعد نفسها.
في أي خطة
مشمولة في خطة Top-Rated Team API، وبالمفتاح نفسه الذي تستخدمه مع LinkedIn API: تسعة دولارات لكل مقعد شهريًا، وسبعة ابتداءً من مئة مقعد. وتحتاج إلى عدد من المقاعد يساوي عدد النوع الذي لديك منه أكثر من غيره — حسابات LinkedIn أو أرقام WhatsApp أو حسابات X أو حسابات صندوق الوارد — وتغطي تجربة الثلاثين يومًا مقعدًا واحدًا.