Google Ads API Explorer

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

יתרונות

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

שנתחיל?

  1. עוברים למסמכי התיעוד: עוברים אל מסמכי התיעוד של ההפניות ובוחרים את השירות והשיטה שרוצים לבדוק, למשל 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: אפשר להשתמש בכלי לבדיקת נתונים כדי להריץ מחרוזת של Google Ads Query Language‏ (GAQL) ולוודא שמבנה ה-JSON שמוחזר תואם למה שמצופה מהאפליקציה.
  • אימות פרוטוקול: בודקים את כותרות ה-HTTP המדויקות ואת ההיררכיה של ה-JSON שנדרשים לגרסה ספציפית של ה-API.