ממשקי API מתקדמים בסקריפטים של Google Ads מאפשרים למפתחים להתחבר לממשקי API ציבוריים מסוימים של Google עם פחות הגדרות מאשר שימוש בממשקי ה-HTTP שלהם. אפשר להשתמש בממשקי ה-API האלה בדומה לשירותים המובנים של סקריפטים, והם מציעים את אותן נוחות כמו השלמה אוטומטית והרשאה אוטומטית.
בדף קטעי הקוד שלנו יש כמה דוגמאות שמראות איך להשתמש בממשקי ה-API האלה.
ממשקי API מתקדמים שזמינים
- Google Analytics
- אתם יכולים להשתמש ב-Google Analytics כדי לעקוב אחרי תנועת הגולשים שמגיעה לאתר שלכם ולהתאים את הצעות המחיר בקמפיין בהתאם. אם מקשרים נכס ב-Google Analytics לחשבון Google Ads, אפשר גם לנתח את פעילות הלקוחות באתר. המידע הזה יכול לספק לכם תמונה מלאה יותר לגבי נפח המכירות או התנועה לאתר שמקורו ב-Google Ads, ויעזור לכם לשפר את המודעות ואת האתר. במדריך להגדרת Analytics לאתר או לאפליקציה שבמרכז העזרה אפשר לקרוא מידע נוסף על קישור חשבונות Analytics ו-Google Ads.
- Google BigQuery
- אפשר לטעון כמויות גדולות של נתונים ל-Google Cloud Storage, ואז להריץ שאילתות על הנתונים האלה באמצעות Google BigQuery. לדוגמה, אתם יכולים לטעון נתוני מזג אוויר ציבוריים מ-10 השנים האחרונות, ואז להריץ שאילתה כדי לקבל את הטמפרטורה הממוצעת באזור מסוים בסקריפט שמשתמש במידע הזה כדי לשנות את הצעות המחיר. שימוש נוסף הוא ביצוע חישובים על נתוני הביצועים של החשבון לאורך כמה שנים.
- יומן Google
- הסקריפט יכול ליצור אירועים למשימות עתידיות (לדוגמה, להריץ דוח ביצועים לקמפיינים בעוד שבועיים), או לבצע פעולות על סמך רשומה שיצרתם ביומן (לדוגמה, להפעיל קמפיין בתאריך מסוים).
- Google Slides
- הסקריפט יכול לייצא פרטים או נתונים סטטיסטיים של קמפיין ל-Google Slides כדי לפרסם את המידע בפורמט שנוח להצגה.
- Google Tasks
- הסקריפט יכול ליצור רשימת תזכורות למשימות עתידיות (לדוגמה, הפעלת דוח ביצועים לקמפיינים בעוד שבועיים), או לבצע פעולות על סמך רשומה שיצרתם ברשימת התזכורות (לדוגמה, הפעלת קמפיין בתאריך מסוים).
- Merchant API
- הסקריפט יכול להשתמש ב-Merchant API כדי להעלות ולנהל את כרטיסי המוצר ולנהל את החשבונות שלכם ב-Google Merchant Center. בסקריפטים, האפשרות הזו יכולה להיות שימושית לבדיקת כרטיסי מוצר ולקישור מוצרים ספציפיים למודעות ספציפיות. ל-Merchant API יש ממשקי API משניים שאפשר להפעיל בנפרד בתיבת הדו-שיח Advanced APIs. מידע נוסף על קישור חשבון Google Merchant Center זמין במדריך הרשמה כמפתח.
- תוכן שקשור לשופינג
- הסקריפט יכול להשתמש ב-Google Content API for Shopping כדי להעלות ולנהל את כרטיסי המוצר ולנהל את החשבונות ב-Google Merchant Center. בסקריפטים, האפשרות הזו יכולה להיות שימושית לבדיקת כרטיסי מוצר ולקישור מוצרים ספציפיים למודעות ספציפיות. הערה: אנחנו נוציא משימוש את Content API for Shopping ב-18 באוגוסט 2026. במקום זאת, אפשר להשתמש ב-Merchant API, שמתואר בקטע הקודם.
- YouTube ו-YouTube Analytics
- אתם יכולים לאחזר ולעדכן את הסרטונים, הפלייליסטים וכו', וגם את נתוני הביצועים של הסרטונים כדי לקבל החלטות לגבי בידינג.
הפעלת ממשקי API מתקדמים
כדי לראות אילו ממשקי Google API זמינים כממשקי API מתקדמים, לוחצים על הלחצן Advanced APIs (ממשקי API מתקדמים) בסרגל העריכה העליון.
תיפתח תיבת הדו-שיח ממשקי API מתקדמים. מסמנים את ממשקי ה-API שרוצים להפעיל.
לאחר מכן, לוחצים על הקישור Google API Console כדי להציג את הדף קונסולה לממשקי API במסוף, עם הפרויקט שמשויך לסקריפט. לחלופין, אם הפרויקט עדיין לא נבחר, בוחרים אותו מהרשימה הנפתחת Project. בסרגל החיפוש, מזינים את שם ה-API שרוצים להשתמש בו בסקריפט.
בתוצאות החיפוש, בוחרים את ה-API ובדף הבא בוחרים באפשרות הפעלה. אם מופיע לחצן השבתה, סימן שה-API הזה כבר מופעל. חוזרים על הפעולה הזו לכל API שרוצים להפעיל.
כדי לראות את רשימת ממשקי ה-API המופעלים בפרויקט, בוחרים בדף מרכז הבקרה. מוודאים שכל ממשקי ה-API המתקדמים שרוצים להשתמש בהם בסקריפט מופיעים ברשימה.
עכשיו סוגרים את תיבת הדו-שיח Advanced APIs (ממשקי API מתקדמים) כדי לחזור לכלי העריכה. ממשקי ה-API החדשים יופעלו בסקריפט ויהיו זמינים ברשימת ההשלמה האוטומטית.
שיקולים אחרונים
יש כמה דברים שחשוב לזכור כשעובדים עם ממשקי API מתקדמים.
מזהה פרויקט
לכל סקריפט של Google Ads יש מזהה פרויקט ב-Google Cloud (שנקרא גם מספר פרויקט) שמשויך אליו. כדי למצוא את מספר הפרויקט של הסקריפט, פותחים את הדף Google API Console מתיבת הדו-שיח Advanced APIs. מזהה הפרויקט הזה נוצר כשיוצרים את הסקריפט, והוא משויך למשתמש שיצר את סקריפט Google Ads. אם המשתמש שיצר את הסקריפט יוסר מהחשבון בשלב מאוחר יותר, משתמש שינסה לגשת לסקריפט יתבקש לאשר מחדש את הסקריפט ולהגדיר מחדש את התלות המתקדמת ב-API. ייווצר גם מזהה פרויקט חדש של Google Developer, ותצטרכו להגדיר מחדש את ממשקי ה-API המתקדמים, כמו שמוסבר בהמשך המסמך הזה.
תלויות
רק המשתמש שיצר את הסקריפט בחשבון יכול לשנות את התלות של הסקריפט בממשקי API מתקדמים.
הרשאות
כשניגשים לממשקי ה-API, סקריפט משתמש בהרשאות של המשתמש שהעניק הרשאה לסקריפט. צריך לוודא שלמשתמש שאישר את הסקריפט יש את הגישה הנדרשת לכל ממשקי ה-API המתקדמים שבהם נעשה שימוש, וגם לנתונים שהסקריפט צריך. אם אתם משתמשים ב-Google Analytics API, צריך לוודא שלמשתמש שנתן הרשאה לסקריפט יש את ההרשאות הנדרשות לחשבון Analytics שאליו מתבצעת גישה.
תנאים והגבלות
לכל אחד מממשקי ה-API המתקדמים עשויים להיות תנאים והגבלות משלו, שצריך לאשר כשמפעילים את ה-API ב-Google API Console.
מכסה
לרוב ממשקי ה-API המתקדמים יש מכסה יומית בחינם שמשויכת אליהם. אם הסקריפט יחרוג מהמכסה הזו, ה-API יפסיק לפעול עד שתבקשו נתונים נוספים או עד שהמכסה החינמית תתחדש. כדי לעקוב אחרי המכסה שהסקריפט צורך, פותחים את Google API Console לסקריפט מתיבת הדו-שיח Advanced APIs. ב-Google API Console יש גם אפשרות לבקש מכסה נוספת ל-API.
חיוב
חלק מממשקי ה-API המתקדמים מחייבים תשלום על השימוש. התשלומים האלה מנוהלים דרך פרויקט Google Cloud שמשויך לסקריפט, ולא דרך Google Ads. במאמרי עזרה שלנו מוסבר איך להפעיל חיוב בפרויקט בענן של Google Cloud של הסקריפט.