مستكشف Google Ads API هو بيئة تنفيذ تفاعلية تتيح لك إنشاء طلبات بيانات من واجهة برمجة التطبيقات وإرسالها مباشرةً من متصفّحك. وهو مضمّن في المستندات المرجعية ويتولّى التعامل مع تعقيدات المصادقة باستخدام OAuth 2.0 وتنسيق حمولة JSON، ما يتيح لك اختبار خدمات وأساليب معيّنة بدون كتابة أي سطر من الرمز البرمجي.
المزايا
- الاختبار بدون رمز برمجي: يمكنك تنفيذ طلبات بيانات من واجهة برمجة التطبيقات (القراءة والكتابة) مباشرةً من المستندات بدون إعداد بيئة تطوير محلية.
- اكتشاف البروتوكول: يمكنك الاطّلاع على البنية الدقيقة لطلبات HTTP واستجاباته لفهم طريقة عمل واجهة برمجة التطبيقات.
- إنشاء النماذج الأولية بدون عوائق: يمكنك التحقّق من سلوك نقطة النهاية وفحص استجابات واجهة برمجة التطبيقات الأولية على الفور قبل تنفيذ المنطق في تطبيقك.
- المصادقة المبسّطة: تدير الأداة تلقائيًا مسارات OAuth 2.0، ما يتيح لك التركيز على طلب البيانات من واجهة برمجة التطبيقات بدلاً من إدارة بيانات الاعتماد.
الخطوات الأولى
- الانتقال إلى المستندات: انتقِل إلى المستندات المرجعية واختَر الخدمة والطريقة اللتين تريد اختبارهما، مثل
GoogleAdsService/Search. - فتح المستكشف: ابحث عن لوحة "تجربتها!" على يسار الصفحة.
- ضبط الطلب:
- أدخِل معلّمات الطلب المطلوبة، مثل
developer-tokenوlogin-customer-id. - حدِّد نص الطلب باستخدام محرِّر JSON التفاعلي إذا كانت الطريقة تتطلّب حمولة، مثل عمليات
mutate.
- أدخِل معلّمات الطلب المطلوبة، مثل
- التنفيذ: انقر على تنفيذ لإرسال الطلب. ستعرض الأداة طلب HTTP الكامل واستجابة JSON المباشرة من واجهة برمجة التطبيقات.
الميزات الرئيسية
- التنفيذ المباشر: يمكنك إجراء عمليات
searchوmutateفي الوقت الفعلي على حساباتك الإنتاجية أو الاختبارية. - تنسيق حمولة JSON: يمكنك إنشاء كائنات JSON معقّدة بشكل تفاعلي للطلبات، مع تمييز الأداة للحقول المطلوبة وبُنى المخططات الصالحة.
- أقنعة الحقول: يمكنك اختبار منطق
update_maskلمعرفة كيفية عمل عمليات تعديل الموارد الجزئية في الممارسة العملية. - فحص الأخطاء: يمكنك الاطّلاع على رسائل وأكواد الخطأ التفصيلية (مثل
QUERY_ERRORأوAUTHENTICATION_ERROR) في الاستجابة الأولية لتسهيل عملية تصحيح الأخطاء بشكل أسرع. - تصدير الرمز البرمجي: يمكنك تصدير أوامر
curlأو طلبات HTTP الأولية أو نموذج رمز JavaScript من العرض الموسّع لمستكشف واجهة برمجة التطبيقات.
أمثلة على حالات الاستخدام
- تدقيق إعدادات الحساب: يمكنك استرداد الإعدادات أو البيانات الوصفية على مستوى الحساب بسرعة من خلال تنفيذ طلب
getأوsearch. - اختبار عمليات التعديل: يمكنك التحقّق من نجاح عملية إنشاء حملة أو تعديل ميزانية قبل نشر الرمز البرمجي في بيئة الإنتاج.
- تصحيح أخطاء GAQL: يمكنك استخدام المستكشف لتشغيل سلسلة بلغة طلبات بحث Google Ads (GAQL) والتحقّق من أنّ بنية JSON التي يتم عرضها تتطابق مع توقّعات تطبيقك.
- التحقّق من البروتوكول: يمكنك فحص عناوين HTTP الدقيقة وبنية JSON المتداخلة المطلوبة لإصدار معيّن من واجهة برمجة التطبيقات.