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

כשעובדים עם 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:

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

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

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

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

  • נכנסים אל Google API Console.
  • בוחרים את הפרויקט בתפריט הנפתח שבפינה השמאלית העליונה של הדף.
  • בתפריט השמאלי, עוברים אל 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.