Google Ads API Explorer

‫Google Ads API Explorer هي بيئة تنفيذ تفاعلية تتيح لك إنشاء طلبات بيانات من واجهة برمجة التطبيقات وإرسالها مباشرةً من متصفّحك. وهي مضمّنة في المستندات المرجعية، وتتعامل مع تعقيدات مصادقة OAuth 2.0 وتنسيق حمولة JSON، ما يتيح لك اختبار خدمات وطرق معيّنة بدون كتابة أي سطر من الرموز البرمجية.

المزايا

  • الاختبار بدون استخدام رمز برمجي: يمكنك تنفيذ طلبات بيانات من واجهة برمجة التطبيقات مباشرةً (القراءة والكتابة) من المستندات بدون الحاجة إلى إعداد بيئة تطوير محلية.
  • استكشاف البروتوكول: يمكنك الاطّلاع على البنية الدقيقة لطلبات HTTP واستجاباتها لفهم سلوك واجهة برمجة التطبيقات.
  • إنشاء نماذج أولية منخفضة الاحتكاك: يمكنك التحقّق من سلوك نقطة النهاية وفحص الردود الأولية من واجهة برمجة التطبيقات قبل تنفيذ المنطق في تطبيقك مباشرةً.
  • المصادقة المبسّطة: تدير الأداة مسارات OAuth 2.0 تلقائيًا، ما يتيح لك التركيز على طلب البيانات من واجهة برمجة التطبيقات بدلاً من إدارة بيانات الاعتماد.

البدء

  1. الانتقال إلى المستندات: انتقِل إلى المستندات المرجعية واختَر الخدمة والطريقة اللتين تريد اختبارهما، مثل GoogleAdsService/Search.
  2. فتح "المستكشف": ابحث عن لوحة تجربة هذه الطريقة على يسار الصفحة.
  3. ضبط الطلب:
    • أدخِل مَعلمات الطلب المطلوبة، مثل customerId، ووسِّع العناوين لتقديم عناوين HTTP اختيارية، مثل login-customer-id (مطلوبة فقط عند الوصول إلى حساب من خلال حساب إداري). يُرجى العِلم أنّه تم إيقاف الرموز المميّزة للمطوّرين (developer-token) نهائيًا في 9 سبتمبر 2026، وتتجاهلها خوادم واجهة برمجة التطبيقات، ولكن لا يزال بإمكانك إدخال قيمة إذا طُلب منك ذلك في النموذج.
    • حدِّد نص الطلب باستخدام محرِّر JSON التفاعلي إذا كانت الطريقة تتطلّب حمولة، مثل عمليات search أو mutate.
  4. تنفيذ: انقر على تنفيذ لإرسال الطلب. تعرض الأداة طلب HTTP الكامل واستجابة JSON المباشرة من واجهة برمجة التطبيقات.

الميزات الأساسية

  • التنفيذ المباشر: يمكنك إجراء عمليات search وmutate في الوقت الفعلي على حساباتك التجريبية أو حسابات الإنتاج.
  • تنسيق حمولة JSON: يمكنك إنشاء عناصر JSON معقّدة بشكل تفاعلي للطلبات، مع تسليط الأداة الضوء على الحقول المطلوبة وبُنى المخطط الصالحة.
  • أقنعة الحقول: اختبِر منطق update_mask لمعرفة كيفية عمل التعديلات الجزئية على الموارد من الناحية العملية.
  • فحص الأخطاء: يمكنك الاطّلاع على رسائل ورموز الأخطاء المفصّلة (مثل QUERY_ERROR أو AUTHENTICATION_ERROR) في الاستجابة الأولية لتسهيل تصحيح الأخطاء بشكل أسرع.
  • تصدير الرموز البرمجية: يمكنك تصدير أوامر curl أو طلبات HTTP الأولية أو نموذج رمز JavaScript البرمجي من العرض الموسّع لـ مستكشف واجهات برمجة التطبيقات.

أمثلة على حالات الاستخدام

  • مراجعة إعدادات الحساب: يمكنك استرداد الإعدادات أو البيانات الوصفية على مستوى الحساب بسرعة من خلال تنفيذ طلب GoogleAdsService/Search على المورد customer.
  • اختبار عمليات التغيير: تأكَّد من نجاح عملية إنشاء حملة أو تعديل الميزانية قبل نشر الرمز البرمجي في بيئة الإنتاج.
  • تصحيح أخطاء GAQL: استخدِم Explorer لتشغيل سلسلة لغة طلب البحث في "إعلانات Google" (GAQL) والتأكّد من أنّ بنية JSON التي تم عرضها تتطابق مع توقعات تطبيقك.
  • التحقّق من البروتوكول: يمكنك الاطّلاع على عناوين HTTP وتركيب JSON المطلوبين لإصدار معيّن من واجهة برمجة التطبيقات.