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