Google Ads API Explorer

‫Google Ads API Explorer הוא סביבת הרצה אינטראקטיבית שמאפשרת ליצור ולשלוח בקשות API בזמן אמת ישירות מהדפדפן. הוא מוטמע במאמרי העזרה ומטפל במורכבות של אימות OAuth 2.0 ועיצוב המטען הייעודי (payload) בפורמט JSON, כך שתוכלו לבדוק שירותים ושיטות ספציפיים בלי לכתוב שורת קוד אחת.

יתרונות

  • בדיקה בלי צורך בתכנות: אפשר לבצע קריאות ל-API בזמן אמת (גם קריאה וגם כתיבה) ישירות מהמסמכים, בלי להגדיר סביבת פיתוח מקומית.
  • גילוי פרוטוקולים: אפשר לראות את המבנה המדויק של בקשות ותגובות HTTP כדי להבין איך ה-API מתנהג.
  • יצירת אב טיפוס בקלות: אתם יכולים לאמת את ההתנהגות של נקודת הקצה ולבדוק את התגובות הגולמיות מה-API לפני שאתם מטמיעים את הלוגיקה באפליקציה.
  • אימות פשוט: הכלי מנהל את תהליכי OAuth 2.0 באופן אוטומטי, כך שאתם יכולים להתמקד בבקשת ה-API ולא בניהול פרטי הכניסה.

שנתחיל?

  1. עוברים למאמרי העזרה: נכנסים למאמרי העזרה ובוחרים את השירות וה-method שרוצים לבדוק, למשל GoogleAdsService/Search.
  2. פתיחת ה-Explorer: מחפשים את החלונית Try this method בצד ימין של הדף.
  3. מגדירים את הבקשה:
    • מזינים את הפרמטרים הנדרשים של הבקשה, כמו customerId, ומרחיבים את הכותרות כדי לספק כותרות HTTP אופציונליות כמו login-customer-id (נדרש רק כשניגשים לחשבון דרך חשבון ניהול). שימו לב: אסימוני פיתוח (developer-token) הוצאו משימוש ב-9 בספטמבר 2026, ושרתי ה-API מתעלמים מהם, אבל עדיין אפשר להזין ערך אם הטופס מבקש זאת.
    • אם השיטה דורשת מטען ייעודי (payload), כמו בפעולות search או mutate, מגדירים את גוף הבקשה באמצעות עורך ה-JSON האינטראקטיבי.
  4. ביצוע: לוחצים על ביצוע כדי לשלוח את הבקשה. הכלי מציג את בקשת ה-HTTP המלאה ואת התגובה בזמן אמת בפורמט JSON מה-API.

תכונות עיקריות

  • הרצה בזמן אמת: אפשר לבצע פעולות search ו-mutate בזמן אמת בחשבונות הייצור או הבדיקה.
  • עיצוב מטען ייעודי (payload) בפורמט JSON: אפשר ליצור באופן אינטראקטיבי אובייקטים מורכבים בפורמט JSON לבקשות, והכלי מדגיש את השדות הנדרשים ואת מבני הסכימה התקינים.
  • מסכות שדות: בודקים את הלוגיקה של update_mask כדי לראות איך עדכוני משאבים חלקיים פועלים בפועל.
  • בדיקת שגיאות: אפשר לראות הודעות וקודי שגיאה מפורטים (כמו QUERY_ERROR או AUTHENTICATION_ERROR) בתגובה הגולמית כדי לזרז את תהליך איתור הבאגים.
  • ייצוא קוד: ייצוא פקודות curl, בקשות HTTP גולמיות או קוד JavaScript לדוגמה מהתצוגה המורחבת של API Explorer.

תרחישים לדוגמה

  • בדיקת הגדרות החשבון: אפשר לאחזר במהירות הגדרות או מטא-נתונים ברמת החשבון על ידי הפעלת בקשת GoogleAdsService/Search מול מקור customer.
  • מוטציות בדיקה: מוודאים שהקמפיין נוצר או שהתקציב עודכן בהצלחה לפני שפורסים את הקוד בסביבת הייצור.
  • ניפוי באגים ב-GAQL: אתם יכולים להשתמש ב-Explorer כדי להריץ מחרוזת של Google Ads Query Language‏ (GAQL) ולוודא שמבנה ה-JSON שמוחזר תואם לציפיות של האפליקציה.
  • אימות פרוטוקול: בודקים את כותרות ה-HTTP המדויקות ואת ההיררכיה של ה-JSON שנדרשים לגרסה ספציפית של ה-API.