קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
כשעובדים עם 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 Cloud
הפרויקט ב-Google API Console מכיל את פרטי הכניסה של OAuth של האפליקציה וקובע את הגישה ל-Google Ads API. כדי לוודא שיש גישה לחשבון הזה, צריך להגדיר כינוי משותף כבעלים של החשבון.
כדי לעדכן את הבעלים של הפרויקט ב-Google API Console, פועלים לפי השלבים הבאים:
שיטה נפוצה לניהול חשבונות באמצעות Google Ads API היא לקשר את כל החשבונות לחשבון ניהול משותף, ולבצע קריאות ל-API לכל החשבונות באמצעות פרטי הכניסה של חשבון הניהול העליון. בהגדרה הזו:
המפתח מנפיק אסימון רענון באמצעות פרטי הכניסה של משתמש שיש לו גישה לחשבון הניהול ב-Google Ads.
המפתח מגדיר את הכותרת login_customer_id כמספר הלקוח של חשבון הניהול ב-Google Ads, ואת הכותרת customer_id כמספר הלקוח של החשבון שאליו מתבצעות קריאות ה-API.
סיכון פוטנציאלי אחד בהגדרה הזו הוא שאם המשתמש המורשה מאבד את הגישה לחשבון הניהול ב-Google Ads, טוקן הרענון כבר לא תקף וכל קריאות ה-API נכשלות. כדי למנוע את התרחיש הזה, אפשר להזמין כתובת אימייל משותפת לניהול חשבון הניהול הזה ב-Google Ads עם רמות הגישה המתאימות.
משתמשים בכתובת האימייל הזו כדי להנפיק את אסימון הרענון לביצוע קריאות ל-API.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-09-05 (שעון UTC)."],[[["\u003cp\u003eWhen working with the Google Ads API, ensure continuous access by using shared team aliases for contact, access management, and authentication purposes instead of individual user emails.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Ads API contact email is used for crucial communications, update it to a shared alias to keep your team informed about API reviews, audit requests, and production emergencies.\u003c/p\u003e\n"],["\u003cp\u003eSafeguard your Google Cloud Console account by granting ownership to a shared team alias, ensuring access to your application's OAuth credentials and control over API access.\u003c/p\u003e\n"],["\u003cp\u003eFor managing multiple Google Ads accounts, link them under a manager account and grant access to a shared alias for refresh token generation and uninterrupted API functionality.\u003c/p\u003e\n"],["\u003cp\u003eRegularly monitor and update these email addresses and access levels to maintain seamless API operations and avoid disruptions caused by personnel changes.\u003c/p\u003e\n"]]],[],null,["# Shared aliases\n\nWhen working with the Google Ads API, there are multiple places where email addresses\nare used for contact and access management, the most important of which are the\nfollowing:\n\n- **Google Ads API contact email**: This is the email listed as the contact in the API Center of the Google Ads UI.\n- **Google Cloud Console account email**: This is the email that has administrator access to the Google Cloud Console account used for your OAuth 2.0 application.\n- **Google Ads manager account email(s)**: These are the emails that have administrator permissions on the manager Google Ads account(s) you access through the Google Ads API. When you generate a refresh token for your application, you usually authenticate your Google Ads API application with one of these emails.\n\nWe strongly recommend using shared team aliases so that you don't lose access to\nthese accounts when individual team members switch teams or leave the company.\nThe rest of this guide elaborates on each of the emails listed earlier and how\nyou can update it to use a shared team alias instead of an individual user's\nemail address.\n\nGoogle Ads API contact email\n----------------------------\n\nThe Google Ads API contact email is an email address you provide when signing up for\nthe Google Ads API. You should ensure access to this alias and monitor emails sent to\nthis address regularly. Google uses this email address to contact your team\nduring API reviews, audit requests, or production emergencies that require\nimmediate attention. Use a shared team alias as the contact email to ensure that\nthe whole team receives these notifications.\n\nFollow these steps to update the API contact email:\n\n1. Sign in to your Google Ads [Manager\n Account](//ads.google.com/home/tools/manager-accounts/).\n\n2. Click **Admin** at the bottom left of the screen.\n\n3. Under **Manager account settings** , click **API center**.\n\n4. Under **Developer details** , note the API contact email. Click the down arrow\n and edit the email. Click **Save**.\n\nGoogle Cloud Console account\n----------------------------\n\nThe **Google API Console** project contains your application's OAuth credentials\nand controls access to the Google Ads API. Ensure access to this account by making a\nshared alias the account owner.\n\nFollow these steps to update the Google API Console project's owner:\n\n- Sign in to [**Google API Console**](//console.developers.google.com).\n- Select your project from the drop-down menu on the top-left corner of the page.\n- Navigate to **IAM and admin \\\u003e IAM** from the left menu.\n- Click the **Grant Access** button.\n- Enter the shared email address under the **Add principals** section.\n- Assign the **Owner** role.\n- Click the **Save** button. Refer to the Cloud documentation to learn more about [granting and revoking access](//cloud.google.com/iam/docs/granting-changing-revoking-access#single-role).\n\nGoogle Ads manager account\n--------------------------\n\nA common method of managing accounts using the Google Ads API is to link all your\naccounts under a common manager account, and make API calls to all the accounts\nusing the top-most manager account's credentials. In this configuration:\n\n- The developer issues a refresh token using the credentials of a user who has access to the Google Ads manager account.\n- The developer sets the [`login_customer_id`](/google-ads/api/docs/get-started/select-account#user_access_login_customer_id_and_customer_id) header as the customer ID of the Google Ads manager account, and the `customer_id` header as the customer ID of the account to which API calls are made.\n\nOne potential risk of this setup is that if the authorized user loses access to\nthe Google Ads manager account, the refresh token is no longer valid and all API\ncalls fail. To avoid this scenario, you can invite a shared email alias to\nmanage this Google Ads manager account with the [appropriate access levels](//support.google.com/google-ads/answer/9978556).\nUse this shared email alias to issue the refresh token for making API calls."]]
