ממשקי ה-API המתקדמים בסקריפטים של Google Ads מאפשרים למפתחים מנוסים להתחבר לממשקי API ציבוריים מסוימים של Google עם הגדרות נמוכות יותר בהשוואה לשימוש בממשקי ה-HTTP שלהם. ממשקי ה-API האלה דומים לשירותים המובנים בסקריפטים, והם מציעים את אותן נוחות כמו השלמה אוטומטית והרשאה אוטומטית.
שימושים אפשריים לממשקי API מתקדמים
- Google Analytics
- אפשר להשתמש ב-Google Analytics כדי לעקוב אחרי התנועה שמגיעה לאתר ולשנות את הצעות המחיר של הקמפיין בהתאם. אם תקשרו נכס ב-Google Analytics לחשבון Google Ads, תוכלו גם לנתח את פעילות הלקוחות באתר. מידע זה יכול לספק לך תמונה מלאה יותר לגבי נפח המכירות והתנועה לאתר מ-Google Ads, ויעזור לך לשפר את המודעות ואת האתר. מידע נוסף על קישור חשבונות Analytics ו-Google Ads זמין במרכז העזרה.
- Google BigQuery
- אפשר לטעון כמויות גדולות של נתונים ל-Google Cloud Storage, ואז לבצע שאילתות לגבי הנתונים האלה באמצעות Google BigQuery. לדוגמה, ניתן לך לטעון נתוני מזג אוויר ציבוריים מ-10 השנים האחרונות, ולאחר מכן להריץ שאילתה על הטמפרטורה הממוצעת באזור מסוים בסקריפט שמתבסס על המידע הזה לצורך התאמת הצעות מחיר. שימוש נוסף הוא עיבוד מספרים של נתוני הביצועים של החשבון לאורך כמה שנים.
- YouTube ו-YouTube Analytics
- אפשר לאחזר ולעדכן את הסרטונים, הפלייליסטים וכו', וכן את נתוני הביצועים של הסרטונים כדי לקבל החלטות לגבי בידינג.
- יומן Google
- הסקריפט יכול ליצור אירועים למשימות עתידיות (למשל, להריץ דוח ביצועים של הקמפיינים בעוד שבועיים מהיום), או לבצע פעולות על סמך רשומה שיצרתם ביומן (למשל, הפעלת קמפיין בתאריך מסוים).
- תוכן של קניות
- הסקריפט שלך יכול להשתמש ב-Google Content API for Shopping ב-Apps Script. ה-API הזה מאפשר למשתמשי Google Merchant Center להעלות ולנהל את כרטיסי המוצר שלהם, ולנהל את החשבונות שלהם ב-Merchant Center. בסקריפטים, כדאי לבדוק את כרטיסי המוצר ולקשר מוצרים ספציפיים למודעות ספציפיות.
- Google Tasks
- הסקריפט יכול ליצור רשימת תזכורות למשימות עתידיות (למשל, להריץ דוח ביצועים לקמפיינים שלכם בעוד שבועיים מהיום), או לבצע פעולות על סמך רשומה שיצרתם ברשימת התזכורות (למשל, הפעלת קמפיין בתאריך מסוים).
- Google Slides
- הסקריפט יכול לייצא פרטי קמפיין או נתונים סטטיסטיים ל-Google Slides כדי לפרסם מידע כזה בפורמט שניתן להציג.
הפעלת ממשקי API מתקדמים
כדי לראות אילו Google APIs זמינים כממשקי API מתקדמים, לוחצים על הלחצן Advanced APIs בסרגל העורך העליון.
פעולה זו תציג את תיבת הדו-שיח ממשקי API מתקדמים. מסמנים את ממשקי ה-API שרוצים להפעיל.
לאחר מכן לוחצים על הקישור Google API Console על מנת להציג את הדף API Console במסוף עם הפרויקט שמשויך לסקריפט. לחלופין, אם הפרויקט עדיין לא נבחר, בוחרים אותו מהרשימה הנפתחת Project. כדי לחפש את ממשקי ה-API שבהם רוצים להשתמש בסקריפט, מזינים את שם ה-API בסרגל החיפוש.
בוחרים את ה-API בתוצאות החיפוש, ובדף הבא בוחרים באפשרות Enable (הפעלה). אם מופיע הלחצן Disable (השבתה), ה-API הזה כבר מופעל. חוזרים על הפעולה הזו לכל API שרוצים להפעיל.
כדי לראות את רשימת ממשקי ה-API שמופעלים בפרויקט, לוחצים על הדף Dashboard. מוודאים שכל ממשקי ה-API המתקדמים שבהם רוצים להשתמש בסקריפט מופיעים ברשימה.
עכשיו צריך לסגור את תיבת הדו-שיח של ממשקי ה-API המתקדמים כדי לחזור לעורך. ממשקי ה-API החדשים יופעלו עבור הסקריפט שלכם ויהיו זמינים ברשימת ההשלמה האוטומטית.
ממשקי API זמינים
ממשקי ה-API הבאים זמינים לשימוש:
| שם ה-API | מאמרי עזרה |
|---|---|
| Google Analytics | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| יומן Google | https://developers.google.com/apps-script/advanced/calendar |
| Google Slides | https://developers.google.com/apps-script/advanced/slides |
| Google Tasks | https://developers.google.com/apps-script/advanced/tasks |
| תוכן של קניות | https://developers.google.com/apps-script/advanced/shopping-content |
| YouTube | https://developers.google.com/apps-script/advanced/youtube |
| YouTube Analytics | https://developers.google.com/apps-script/advanced/youtube-analytics |
תוכלו גם לעיין בדף קטעי הקוד כדי לראות כמה דוגמאות לאופן השימוש בממשקי ה-API האלה.
שיקולים אחרונים
יש כמה דברים שכדאי לזכור כשעובדים עם ממשקי API מתקדמים.
מזהה הפרויקט
לכל סקריפט של Google Ads משויך מזהה פרויקט של Google Cloud Platform (שנקרא גם מספר פרויקט). כדי לאתר את מספר הפרויקט של הסקריפט, פותחים את הדף Google API Console מתיבת הדו-שיח Advanced APIs. מזהה הפרויקט הזה נוצר בזמן יצירת הסקריפט, והוא מקושר למשתמש שיצר את הסקריפט של Google Ads. אם המשתמש שיצר את הסקריפט יוסר מהחשבון בהמשך, משתמש שינסה לגשת לסקריפט יתבקש לאשר מחדש את הסקריפט ולהגדיר שוב יחסי תלות מתקדמים של API. ייווצר גם מזהה פרויקט חדש למפתחים ב-Google, ויהיה עליך להגדיר שוב את ממשקי ה-API המתקדמים, כפי שמוסבר למעלה במסמך הזה.
יחסי תלות
רק המשתמש שיצר את הסקריפט בחשבון יכול לשנות את יחסי התלות של ממשקי ה-API המתקדמים של אותו סקריפט.
הרשאות
כשניגשים לממשקי ה-API, סקריפט משתמש בהרשאות של המשתמש שאישר את הסקריפט. חשוב לוודא שלמשתמש שאישר את הסקריפט יש את הגישה הנדרשת לכל ממשקי ה-API המתקדמים, וגם לנתונים שהסקריפט צריך. אם אתם משתמשים ב-Google Analytics API, חשוב לוודא שלמשתמש שאישר את הסקריפט יש את ההרשאות הנדרשות כדי לגשת לחשבון Analytics.
תנאים והגבלות
לכל אחד מממשקי ה-API המתקדמים עשויים להיות תנאים והגבלות משלו, שאותם עליכם לאשר כשמפעילים את ה-API במסוף Google API.
מכסה
לרוב ממשקי ה-API המתקדמים יש מכסה יומית בחינם. אחרי שהסקריפט יחרוג מהמכסה הזו, ה-API יפסיק לפעול עד שתבקשו נתונים נוספים או עד שתחדשו את המכסה החינמית. כדי לעקוב אחרי המכסה לסקריפט, תוכלו לפתוח את מסוף Google API של הסקריפט מתיבת הדו-שיח Advanced API. באמצעות מסוף Google API תוכלו לבקש מכסה נוספת ל-API.
חיוב
בחלק מממשקי ה-API המתקדמים תצטרכו לשלם על השימוש. התשלומים האלה מנוהלים באמצעות הפרויקט ב-Google Cloud Platform שמשויך לסקריפט, ולא דרך Google Ads. רוצים לדעת איך מפעילים את החיוב בפרויקט ב-Google Cloud Platform של הסקריפט?