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