Google Ads API Explorer

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

المزايا

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

الخطوات الأولى

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

الميزات الرئيسية

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

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

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