Google Ads API Explorer یک محیط اجرای تعاملی است که به شما امکان می‌دهد درخواست‌های API زنده را مستقیماً از مرورگر خود بسازید و ارسال کنید. این ابزار که در اسناد مرجع جاسازی شده است، پیچیدگی‌های اصالت‌سنجی OAuth 2.0 و قالب‌بندی پایه‌بار JSON را مدیریت می‌کند و به شما امکان می‌دهد سرویس‌ها و روش‌های خاص را بدون نوشتن حتی یک خط کد آزمایش کنید.
مزايا
- آزمایش بدون کد: تماس‌های میانای برنامه‌سازی کاربردی زنده (هم خواندن و هم نوشتن) را مستقیماً از اسناد اجرا کنید، بدون اینکه نیاز به راه‌اندازی محیط توسعه محلی باشد.
- کاوش پروتکل: ساختار دقیق درخواست‌ها و پاسخ‌های HTTP را ببینید تا با نحوه رفتار میانای برنامه‌سازی کاربردی آشنا شوید.
- نمونه‌سازی با اصطکاک کم: رفتار نقطه پایانی را تأیید کنید و پاسخ‌های خام میانای برنامه‌سازی کاربردی را بلافاصله قبل‌از پیاده‌سازی منطق در برنامه‌تان بررسی کنید.
- اصالت‌سنجی ساده‌شده: این ابزار جریان‌های 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 Explorer.
نمونه موارد استفاده
- تنظیمات حساب ممیزی: با اجرای درخواست
GoogleAdsService/Searchدر منبعcustomer، پیکربندی‌ها یا فراداده‌های سطح حساب را به‌سرعت بازیابی کنید. - آزمایش جهش‌ها: موفقیت ایجاد پویش یا به‌روزرسانی بودجه را قبل‌از استقرار کد در تولید درستی‌سنجی کنید.
- اشکال‌زدایی GAQL: از «کاوشگر» برای اجرای رشته زبان پُرسمان Google Ads (GAQL) استفاده کنید و درستی‌سنجی کنید که ساختار JSON برگردانده‌شده با انتظارات برنامه شما مطابقت داشته باشد.
- درستی‌سنجی پروتکل: سرایندهای دقیق HTTP و تودرتو کردن JSON موردنیاز برای نسخه خاصی از میانای برنامه‌سازی کاربردی را بررسی کنید.