ממשקי API מתקדמים בסקריפטים של Google Ads מאפשרים למפתחים להתחבר לממשקי API ציבוריים מסוימים של Google עם פחות הגדרות מאשר שימוש בממשקי ה-HTTP שלהם. אפשר להשתמש בממשקי ה-API האלה בדומה לשירותים המובנים של סקריפטים, והם מציעים את אותן נוחות כמו השלמה אוטומטית והרשאה אוטומטית.
בדף קטעי הקוד שלנו יש דוגמאות שמראות איך להשתמש בממשקי ה-API האלה.
ממשקי API מתקדמים שזמינים
- Google Analytics
- אתם יכולים להשתמש ב-Google Analytics כדי לעקוב אחרי תנועת הגולשים שמגיעה לאתר שלכם ולהתאים את הצעות המחיר בקמפיין בהתאם. אם מקשרים נכס ב-Google Analytics לחשבון Google Ads, אפשר גם לנתח את פעילות הלקוחות באתר. המידע הזה יכול לספק לכם תמונה מלאה יותר לגבי נפח המכירות או התנועה לאתר שמקורו ב-Google Ads, ויעזור לכם לשפר את המודעות ואת האתר. מידע נוסף על קישור חשבונות Analytics ו-Google Ads זמין במדריך הגדרת Analytics לאתר או לאפליקציה במרכז העזרה.
- 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 מתקדמים) בסרגל העריכה העליון כדי להציג את תיבת הדו-שיח Advanced APIs (ממשקי API מתקדמים). בוחרים את ממשקי ה-API שרוצים להפעיל.
לוחצים על שמירה כדי לשמור את הבחירות ולחזור לכלי לעריכת סקריפטים. ממשקי ה-API החדשים יופעלו בסקריפט ויהיו זמינים ברשימת ההשלמה האוטומטית.
שיקולים נוספים
יש כמה דברים שחשוב לזכור כשעובדים עם ממשקי API מתקדמים.
תלויות
רק המשתמש שיצר את הסקריפט בחשבון יכול לשנות את התלות של הסקריפט בממשקי API מתקדמים.
הרשאות
כשניגשים לממשקי ה-API, סקריפט משתמש בהרשאות של המשתמש שהעניק הרשאה לסקריפט. חשוב לוודא שלמשתמש שאישר את הסקריפט יש גישה לכל הנתונים שהסקריפט צריך. אם אתם משתמשים ב-Google Analytics API, אתם צריכים לוודא שלמשתמש שנתן הרשאה לסקריפט יש את ההרשאות הנדרשות לחשבון Analytics שאליו מתבצעת גישה.
שיקולים לגבי סקריפטים מלפני מאי 2019
בסקריפטים שנוצרו לפני מאי 2019, יכול להיות שתצטרכו להפעיל באופן ידני את ממשקי ה-API הרלוונטיים בפרויקט Google Cloud שמקושר לסקריפט. אם הסקריפט שלכם מושפע, יופיע קישור למסוף Google Cloud בתיבת הדו-שיח של ממשקי ה-API המתקדמים.
הפעלת ממשקי API מתקדמים
בסקריפטים שנוצרו לפני 2019, צריך להפעיל באופן ידני כל API מתקדם שרוצים להשתמש בו בסקריפט:
- לוחצים על הלחצן ממשקי API מתקדמים. בתיבת הדו-שיח הבאה, לוחצים על הקישור אל מסוף Google Cloud.
- אם הפרויקט שלכם עדיין לא נבחר, בוחרים אותו מהרשימה הנפתחת Project (פרויקט).
- כדי לחפש את ממשקי ה-API שרוצים להשתמש בהם בסקריפט, מזינים את שם ה-API בסרגל החיפוש.
- בוחרים את ה-API מתוצאות החיפוש ולוחצים על הלחצן 'הפעלה' בדף הבא.
אם המשתמש שיצר את הסקריפט יוסר מהחשבון בשלב מאוחר יותר, כל משתמש חדש שינסה לגשת לסקריפט יתבקש להפעיל מחדש את התלות המתקדמת ב-API, וגם לאשר מחדש את הסקריפט.