جستجوگر API گوگل ادز یک محیط اجرایی تعاملی است که به شما امکان میدهد درخواستهای API را مستقیماً از مرورگر خود ایجاد و ارسال کنید. این ابزار که در مستندات مرجع تعبیه شده است، پیچیدگیهای احراز هویت OAuth 2.0 و قالببندی JSON payload را مدیریت میکند و به شما امکان میدهد سرویسها و روشهای خاص را بدون نوشتن حتی یک خط کد آزمایش کنید.
مزایا
- تست بدون کد: فراخوانیهای API زنده (هم خواندنی و هم نوشتنی) را مستقیماً از مستندات و بدون راهاندازی یک محیط توسعه محلی اجرا کنید.
- کشف پروتکل: ساختار دقیق درخواستها و پاسخهای HTTP را مشاهده کنید تا نحوه رفتار API را درک کنید.
- نمونهسازی اولیه کماصطکاک: رفتار نقطه پایانی را تأیید کنید و پاسخهای خام API را فوراً قبل از پیادهسازی منطق در برنامه خود بررسی کنید.
- احراز هویت سادهشده: این ابزار جریانهای OAuth 2.0 را بهطور خودکار مدیریت میکند و به شما این امکان را میدهد که بهجای مدیریت اعتبارنامه، روی درخواست API تمرکز کنید.
شروع به کار
- به مستندات بروید: به مستندات مرجع بروید و سرویس و روشی را که میخواهید آزمایش کنید، مانند
GoogleAdsService/Searchانتخاب کنید. - اکسپلورر را باز کنید: در سمت راست صفحه، پنل «امتحانش کن!» را پیدا کنید.
- پیکربندی درخواست:
- پارامترهای درخواست مورد نیاز، مانند
developer-tokenوlogin-customer-idرا وارد کنید. - اگر متد به یک payload نیاز دارد، مانند عملیات
`mutate`، بدنه درخواست را با استفاده از ویرایشگر تعاملی JSON تعریف کنید.
- پارامترهای درخواست مورد نیاز، مانند
- اجرا: برای ارسال درخواست، روی اجرا کلیک کنید. این ابزار درخواست کامل HTTP و پاسخ JSON زنده از API را نمایش میدهد.
ویژگیهای کلیدی
- اجرای زنده: عملیات
searchوmutateبه صورت بلادرنگ در حسابهای عملیاتی یا آزمایشی خود انجام دهید. - قالببندی بار داده JSON: به صورت تعاملی اشیاء پیچیده JSON را برای درخواستها بسازید، با این ابزار که فیلدهای مورد نیاز و ساختارهای طرحواره معتبر را برجسته میکند.
- ماسکهای فیلد: یک منطق
update_maskآزمایش کنید تا ببینید بهروزرسانیهای جزئی منابع در عمل چگونه رفتار میکنند. - بررسی خطا: مشاهده پیامها و کدهای خطای دقیق (مانند
QUERY_ERRORیاAUTHENTICATION_ERROR) در پاسخ خام برای تسهیل اشکالزدایی سریعتر. - خروجی کد: دستورات
curl، درخواستهای خام HTTP یا نمونه کد جاوا اسکریپت را از نمای گستردهی API Explorer خروجی بگیرید.
موارد استفاده مثال
- تنظیمات حساب حسابرسی: با اجرای یک درخواست
getیاsearch، پیکربندیها یا فرادادههای سطح حساب را به سرعت بازیابی کنید. - جهشهای آزمایشی: قبل از استقرار کد در محیط عملیاتی، موفقیت ایجاد یک کمپین یا بهروزرسانی بودجه را تأیید کنید.
- اشکالزدایی GAQL: از اکسپلورر برای اجرای یک رشته زبان جستجوی گوگل ادز (GAQL) استفاده کنید و تأیید کنید که ساختار JSON برگردانده شده با انتظارات برنامه شما مطابقت دارد.
- تأیید پروتکل: هدرهای HTTP و JSON تودرتوی مورد نیاز برای یک نسخه خاص API را دقیقاً بررسی کنید.