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

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

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

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

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

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

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

  1. נכנסים לחשבון הניהול ב-Google Ads.

  2. לוחצים על ניהול בפינה הימנית התחתונה של המסך.

  3. בקטע הגדרות חשבון הניהול, לוחצים על מרכז ה-API.

  4. בקטע פרטי המפתח, מציינים את כתובת האימייל ליצירת קשר בנושא ה-API. לוחצים על החץ למטה ועורכים את האימייל. לוחצים על שמירה.

חשבון במסוף Google Cloud

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

כדי לעדכן את הבעלים של פרויקט ב-Google API Console:

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

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

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

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

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