ממשקי ה-API המתקדמים בסקריפטים של Google Ads מאפשרים למפתחים להתחבר לממשקי Google API ציבוריים מסוימים, עם פחות הגדרות מאשר בשימוש בממשקי ה-HTTP שלהם. אתם יכולים להשתמש בממשקי ה-API האלה בדומה לשירותים המובנים של הסקריפטים, והם מציעים את אותן תכונות נוחות כמו השלמה אוטומטית והרשאה אוטומטית.
בדף קטעי הקוד יש דוגמאות שמראות איך להשתמש בממשקי ה-API האלה.
ממשקי API מתקדמים זמינים
- Google Analytics
- הערה: ה-API המתקדם
Analyticsבתיבת הדו-שיח ממשקי API מתקדמים מטרגט את Universal Analytics v3 API שהוצא משימוש, ובקשות אליו נכשלות. סקריפטים של Google Ads לא תומכים בשירותים המתקדמיםAnalyticsDataאוAnalyticsAdminשל Google Analytics 4. כדי לשלוח שאילתה לנתוני Google Analytics 4 מסקריפט, שולחים בקשות HTTPS אל Google Analytics Data API באמצעות השירותUrlFetchAppו-OAuth 2.0. אתם יכולים גם לקשר נכס Google Analytics 4 לחשבון 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 בסרגל העורך העליון כדי להציג את תיבת הדו-שיח Advanced APIs. בוחרים את ממשקי ה-API שרוצים להפעיל.
לוחצים על שמירה כדי לשמור את הבחירות ולחזור לעורך הסקריפטים. ממשקי ה-API החדשים יופעלו בסקריפט ויהיו זמינים ברשימת ההשלמה האוטומטית.
שיקולים נוספים
יש כמה דברים שחשוב לזכור כשעובדים עם ממשקי ה-API המתקדמים.
יחסי תלות
רק המשתמש שיצר את הסקריפט בחשבון יכול לשנות את יחסי התלות של ממשקי ה-API המתקדמים בסקריפט הזה.
הרשאות
כשניגשים לממשקי API מתקדמים, הסקריפט משתמש בהרשאות של המשתמש שאישר את הסקריפט. למשתמש שנותן את ההרשאה צריכה להיות גישה לכל הנתונים שהסקריפט צריך. לדוגמה, כדי להשתמש ב-API המתקדם BigQuery, למשתמש שנותן את ההרשאה צריכות להיות ההרשאות הנדרשות לפרויקט היעד ב-Google Cloud ולמערך הנתונים ב-BigQuery.
שיקולים לגבי סקריפטים שנוצרו לפני מאי 2019
בסקריפטים שנוצרו לפני מאי 2019, יכול להיות שתצטרכו להפעיל באופן ידני את ממשקי ה-API הרלוונטיים בפרויקט בענן של Google שמשויך לסקריפט. כדי לדעת אם הסקריפט שלכם מושפע, אתם יכולים לבדוק אם מופיע קישור למסוף Google Cloud בתיבת הדו-שיח של ממשקי ה-API המתקדמים.
הפעלת ממשקי API מתקדמים
בסקריפטים שנוצרו לפני 2019, צריך להפעיל באופן ידני כל ממשק API מתקדם שרוצים להשתמש בו בסקריפט:
- לוחצים על הכפתור Advanced APIs. בחלון הדו-שיח שנפתח, לוחצים על הקישור למסוף Google Cloud.
- אם הפרויקט לא נבחר, בוחרים אותו מהרשימה הנפתחת Project.
- בשורת החיפוש, מקלידים את שם ה-API שרוצים להשתמש בו בסקריפט.
- בוחרים את ה-API מתוצאות החיפוש ולוחצים על Enable בדף הבא.
אם המשתמש שיצר את הסקריפט יוסר מהחשבון, כל משתמש חדש שינסה לגשת לסקריפט יתבקש להפעיל שוב את יחסי התלות המתקדמים של ה-API, וגם לאשר מחדש את הסקריפט.