כינויים משותפים

כשעובדים עם Google Ads API, יש מספר מקומות שבהם כתובות אימייל משמשות לניהול אנשי קשר וניהול הרשאות גישה, והחשובים שבהם הם:

  • כתובת האימייל ליצירת קשר עם Google Ads API: זו כתובת האימייל הרשומה כאיש הקשר במרכז API בממשק המשתמש של Google Ads.
  • כתובת האימייל של החשבון במסוף Google Cloud: זאת כתובת האימייל עם הרשאת אדמין לחשבון במסוף Google Cloud שמשמש לאפליקציית OAuth 2.0.
  • כתובות האימייל של חשבונות הניהול ב-Google Ads: כתובות האימייל עם הרשאות אדמין בחשבונות הניהול שאליהם אתם נכנסים דרך Google Ads API. כשיוצרים אסימון רענון לאפליקציה, בדרך כלל מאמתים את האפליקציה Google Ads API באמצעות אחת מכתובות האימייל האלה.

מומלץ מאוד להשתמש בכתובות אימייל חלופיות משותפות לצוות כדי לא לאבד את הגישה לחשבונות האלה כשחברי צוות מחליפים צוותים או עוזבים את החברה. בהמשך המדריך נפרט על כל אחת מכתובות האימייל שפירטנו למעלה ומוסבר איך לעדכן אותה כך שתשתמש בכינוי צוות משותף במקום בכתובת אימייל של משתמש ספציפי.

כתובת האימייל ליצירת קשר עם Google Ads API

כתובת האימייל ליצירת קשר עם Google Ads API היא כתובת אימייל שאתם מספקים כשנרשמים ל-Google Ads API. מומלץ לוודא שיש גישה לכתובת האימייל החלופית הזו ולעקוב אחרי הודעות אימייל שנשלחות לכתובת הזו באופן קבוע. כתובת האימייל הזו משמשת את Google כדי ליצור קשר עם הצוות שלכם במהלך בדיקות API, בקשות ביקורת או מקרי חירום שדורשים טיפול מיידי. להשתמש בכתובת אימייל חלופית משותפת של צוות בתור כתובת האימייל ליצירת קשר, כדי להבטיח שכל הצוות יקבל את ההודעות האלה.

כדי לעדכן את כתובת האימייל ליצירת קשר עם ה-API:

  • נכנסים לחשבון הניהול ב-Google Ads שבו השתמשתם כשהגשתם בקשה לקבלת גישה ל-Google Ads API. זה אותו החשבון שבו נמצא קוד המפתח.
  • עוברים אל Tools & Settings (כלים והגדרות) > API Center.
  • לוחצים על החץ בקטע כתובת אימייל ליצירת קשר עם ממשק ה-API.
  • מעדכנים את כתובת האימייל ולוחצים על הלחצן שמירה.

חשבון ב-Google Cloud Console

הפרויקט במסוף Google API מכיל את פרטי הכניסה של האפליקציה ב-OAuth ואת הגישה ל-Google Ads API. כדי להבטיח את הגישה לחשבון הזה, אפשר להגדיר כתובת אימייל חלופית משותפת כבעלים של החשבון.

כדי לעדכן את הבעלים של הפרויקט במסוף Google API, יש לפעול לפי השלבים הבאים:

  • נכנסים אל מסוף Google API.
  • בוחרים את הפרויקט מהתפריט הנפתח בפינה הימנית העליונה של הדף.
  • בתפריט הימני עוברים אל IAM ואדמין > IAM.
  • לוחצים על הלחצן הענקת גישה.
  • מזינים את כתובת האימייל המשותפת בקטע Add principals.
  • מקצים את התפקיד בעלים.
  • לוחצים על הלחצן שמירה. למידע נוסף על הענקה וביטול של גישה, יש לעיין במסמכי העזרה של Cloud.

חשבון ניהול ב-Google Ads

שיטה נפוצה לניהול חשבונות באמצעות Google Ads API היא לקשר את כל החשבונות במסגרת חשבון ניהול משותף, ולבצע קריאות ל-API לכל החשבונות באמצעות פרטי הכניסה ברמה הגבוהה ביותר. בהגדרה הזו:

  • המפתח מנפיק אסימון רענון באמצעות פרטי הכניסה של משתמש שיש לו גישה לחשבון הניהול ב-Google Ads.
  • המפתח מגדיר את הכותרת login_customer_id כמספר הלקוח של חשבון הניהול ב-Google Ads, ואת הכותרת customer_id כמספר הלקוח של החשבון שאליו מתבצעות קריאות ל-API.

אחד הסיכונים האפשריים להגדרה הזו הוא שאם המשתמש המורשה יאבד את הגישה לחשבון הניהול ב-Google Ads, אסימון הרענון כבר לא יהיה תקף וכל הקריאות ל-API ייכשלו. כדי למנוע תרחיש כזה, ניתן לשלוח הזמנה לכתובת אימייל חלופית משותפת כדי לנהל את חשבון הניהול הזה ב-Google Ads עם רמות הגישה המתאימות. ניתן להשתמש בכתובת האימייל החלופית המשותפת הזו כדי להנפיק את אסימון הרענון לביצוע קריאות ל-API.