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