כשעובדים עם Google Ads API, כתובות אימייל משמשות בכמה מקומות ליצירת קשר ולניהול הרשאות גישה. החשובים שבהם:
- כתובת האימייל ליצירת קשר בנושא Google Ads API: כתובות האימייל שהוקצה להן התפקיד בעלים או עריכה בפרויקט שלכם ב-Google Cloud. Google משתמשת בכתובות האלה כדי לשלוח הודעות שירות חיוניות (MSA) והודעות אדמין.
- כתובת האימייל של החשבון במסוף Google Cloud: כתובת האימייל עם הרשאת אדמין לפרויקט בענן ב-Google Cloud שמשמש לאפליקציית OAuth 2.0.
- גישה לחשבון ניהול ב-Google Ads: חשבון השירות (מומלץ) או כתובת האימייל החלופית המשותפת שיש להם הרשאות גישה לחשבונות הניהול ב-Google Ads, שאליהם ניגשים דרך Google Ads API.
בהמשך המדריך נפרט על כל אחד מהחשבונות שצוינו קודם, ונסביר איך להגדיר אותם כך שהשילוב לא יהיה תלוי בכתובת אימייל של משתמש ספציפי.
כתובת האימייל ליצירת קשר בנושא Google Ads API
Google שולחת הודעות אדמיניסטרטיביות, עדכונים לגבי בדיקות API, בקשות לביקורת, הודעות חיוניות על השירות (MSA) והודעות חירום לגבי סביבת הייצור לכתובות האימייל שמשויכות לתפקידים בעלים ועריכה בפרויקט שלכם ב-Google Cloud (ראו כתובות אימייל חדשות ליצירת קשר בנושא API, כי ההגדרה הקודמת של כתובת אימייל ליצירת קשר במרכז ה-API בממשק המשתמש של Google Ads הוצאה משימוש).
כדי לעדכן את כתובת האימייל ליצירת קשר ולוודא שכל הצוות מקבל את ההתראות האלה, צריך להקצות את התפקיד בעלים או עריכה לכתובת אימייל חלופית משותפת של הצוות בפרויקט בענן של Google Cloud, ולעקוב באופן קבוע אחרי האימיילים שנשלחים לכתובת החלופית הזו.
חשבון במסוף Google Cloud
הפרויקט במסוף Google Cloud מכיל את פרטי הכניסה של האפליקציה ל-OAuth, ודרכו אפשר לשלוט בגישה ל-Google Ads API. כדי לוודא שיש גישה לפרויקט, צריך להקצות לאימייל משותף של הצוות את התפקיד בעלים (או עריכה).
כדי להוסיף כתובת אימייל חלופית משותפת כ-Project Owner של פרויקט בענן ב-Google Cloud:
- נכנסים למסוף Google Cloud.
- בוחרים את הפרויקט מרשימת הפרויקטים שבחלק העליון של הדף.
- בתפריט הניווט, לוחצים על IAM & Admin > IAM.
- לוחצים על הענקת גישה.
- בקטע Add principals, מזינים את כתובת האימייל המשותפת בשדה New principals.
- בקטע Assign roles, לוחצים על Select a role ובוחרים באפשרות Basic > Owner (או Basic > Editor).
- לוחצים על שמירה. אם הקציתם את התפקיד בעלים לכתובת אימייל מחוץ לארגון שלכם ב-Google Cloud (או בפרויקט בלי ארגון), Google Cloud שולחת הזמנה באימייל לכתובת האימייל המשותפת, וצריך לאשר את ההזמנה כדי שהתפקיד ייכנס לתוקף. במסמכי התיעוד של Cloud מוסבר איך נותנים ומבטלים גישה.
חשבון ניהול ב-Google Ads
שיטה נפוצה לניהול חשבונות באמצעות Google Ads API היא לקשר את כל החשבונות לחשבון ניהול משותף, ולבצע קריאות ל-API לכל החשבונות באמצעות פרטי הכניסה של חשבון הניהול ברמה העליונה. בהגדרה הזו, המפתח מגדיר את כותרת הבקשה login-customer-id (או את הגדרת התצורה של ספריית הלקוח login_customer_id) למספר הלקוח בן 10 הספרות (ללא מקפים) של חשבון הניהול ב-Google Ads, ומגדיר את היעד customer_id לחשבון התפעולי שאליו מתבצעות הקריאות ל-API.
מומלץ: להשתמש בחשבון שירות
השימוש בחשבון שירות הוא הדרך המועדפת לאימות ולגישה לחשבון ניהול ב-Google Ads. בניגוד לחשבונות של משתמשים פרטיים, חשבון שירות מנוהל בתוך הפרויקט ב-Google Cloud ולא קשור לאדם ספציפי. כך אפשר למנוע הפסקות בשירות כשחברי הצוות מחליפים תפקידים או עוזבים את החברה. כדי ליצור חשבון שירות ולתת לו גישה לחשבון הניהול ב-Google Ads, פועלים לפי המדריך לחשבון שירות.
אפשרות חלופית: שימוש בכתובת אימייל חלופית משותפת
אם בשילוב שלכם אי אפשר להשתמש בחשבון שירות, והוא מסתמך על תהליך אימות של משתמש יחיד, משתמש עם גישה לחשבון הניהול ב-Google Ads מנפיק טוקן רענון מסוג OAuth 2.0.
כדי להימנע מהתרחיש הזה כשמשתמשים בפרטי כניסה של משתמש:
- מזמינים כתובת אימייל חלופית משותפת (שמגובה בחשבון Google פעיל שמופעל בו אימות באמצעות מפתח גישה) לנהל את חשבון הניהול הזה ב-Google Ads עם רמות הגישה המתאימות.
- מאשרים את ההזמנה באמצעות כתובת האימייל החלופית המשותפת.
- משתמשים בכתובת האימייל החלופית המשותפת הזו כדי להנפיק את טוקן הרענון של OAuth לביצוע קריאות ל-API.