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