العناوين البديلة المشتركة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عند استخدام Google Ads API، هناك مواضع متعدّدة يتم فيها استخدام عناوين البريد الإلكتروني لإدارة جهات الاتصال وإمكانية الوصول، وأهمّها ما يلي:
- البريد الإلكتروني المخصّص للتواصل بشأن Google Ads API: هو البريد الإلكتروني المُدرَج كجهة اتصال في "مركز واجهات برمجة التطبيقات" ضمن واجهة مستخدم "إعلانات Google".
- البريد الإلكتروني لحساب Google Cloud Console: هو البريد الإلكتروني الذي لديه إذن وصول المشرف إلى حساب Google Cloud Console المستخدَم لتطبيق OAuth 2.0.
- عناوين البريد الإلكتروني للحسابات الإدارية على "إعلانات Google": هي عناوين البريد الإلكتروني التي لديها أذونات مشرف في الحسابات الإدارية على "إعلانات Google" التي يمكنك الوصول إليها من خلال Google Ads API. عند إنشاء رمز مميّز لإعادة التحميل لتطبيقك،
تتم عادةً مصادقة تطبيق Google Ads API باستخدام أحد عناوين البريد الإلكتروني هذه.
ننصحك بشدة باستخدام أسماء مستعارة مشتركة للفريق حتى لا تفقد إمكانية الوصول إلى هذه الحسابات عندما ينتقل أعضاء الفريق إلى فرق أخرى أو يغادرون الشركة.
تتضمّن بقية هذا الدليل تفاصيل حول كل رسالة إلكترونية مُدرَجة سابقًا وكيفية تعديلها لاستخدام اسم مستعار مشترك للفريق بدلاً من عنوان البريد الإلكتروني الخاص بمستخدم فردي.
عنوان البريد الإلكتروني المخصّص للتواصل بشأن Google Ads API هو عنوان بريد إلكتروني تقدّمه عند الاشتراك في Google Ads API. يجب التأكّد من إمكانية الوصول إلى هذا الاسم المستعار ومراقبة الرسائل الإلكترونية التي يتم إرسالها إلى هذا العنوان بانتظام. تستخدم Google عنوان البريد الإلكتروني هذا للتواصل مع فريقك
أثناء مراجعات واجهة برمجة التطبيقات أو طلبات التدقيق أو حالات الطوارئ التي تتطلّب
معالجة فورية. استخدِم اسمًا مستعارًا مشتركًا للفريق كعنوان البريد الإلكتروني المخصّص لتلقّي الإشعارات لضمان تلقّي الفريق بأكمله لهذه الإشعارات.
اتّبِع الخطوات التالية لتعديل عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات:
سجِّل الدخول إلى حسابك الإداري على "إعلانات Google".
انقر على المشرف في أسفل يمين الشاشة.
ضِمن إعدادات الحساب الإداري، انقر على مركز واجهة برمجة التطبيقات.
ضِمن تفاصيل المطوِّر، سجِّل عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات. انقر على السهم المتّجه للأسفل وعدِّل عنوان البريد الإلكتروني. انقر على حفظ.
حساب Google Cloud Console
يحتوي مشروع وحدة تحكّم Google API على بيانات اعتماد OAuth الخاصة بتطبيقك
ويتحكّم في إمكانية الوصول إلى Google Ads API. تأكَّد من إمكانية الوصول إلى هذا الحساب من خلال تعيين اسم مستعار مشترك كمالك للحساب.
اتّبِع الخطوات التالية لتعديل مالك مشروع Google API Console:
- سجِّل الدخول إلى وحدة تحكّم Google API.
- اختَر مشروعك من القائمة المنسدلة في أعلى يمين الصفحة.
- انتقِل إلى إدارة الهوية وإمكانية الوصول والمشرف > إدارة الهوية وإمكانية الوصول من القائمة اليمنى.
- انقر على الزر منح إذن الوصول.
- أدخِل عنوان البريد الإلكتروني المشترك ضمن قسم إضافة جهات رئيسية.
- امنح دور المالك.
- انقر على الزر حفظ. راجِع مستندات Cloud لمعرفة المزيد حول منح إذن الوصول وإبطاله.
حساب إداري على "إعلانات Google"
تتمثّل إحدى الطرق الشائعة لإدارة الحسابات باستخدام Google Ads API في ربط جميع حساباتك بحساب إداري مشترك، وإجراء طلبات البيانات من واجهة برمجة التطبيقات إلى جميع الحسابات باستخدام بيانات اعتماد الحساب الإداري الأعلى مستوى. في هذا الإعداد:
- يصدر المطوّر رمزًا مميّزًا لإعادة التحقّق باستخدام بيانات اعتماد مستخدم لديه إذن بالوصول إلى الحساب الإداري على "إعلانات Google".
- يضبط المطوّر العنوان
login_customer_id على أنّه رقم تعريف العميل الخاص بالحساب الإداري على "إعلانات Google"، ويضبط العنوان customer_id على أنّه رقم تعريف العميل الخاص بالحساب الذي يتم إجراء طلبات البيانات من واجهة برمجة التطبيقات إليه.
أحد المخاطر المحتملة لهذا الإعداد هو أنّه في حال فقدان المستخدم المفوّض إذن الوصول إلى الحساب الإداري على "إعلانات Google"، لن يكون رمز التحديث صالحًا وستتعذّر جميع طلبات البيانات من واجهة برمجة التطبيقات. لتجنُّب هذا السيناريو، يمكنك دعوة اسم مستعار مشترك للبريد الإلكتروني لإدارة هذا الحساب الإداري على "إعلانات Google" باستخدام مستويات الوصول المناسبة.
استخدِم اسم البريد الإلكتروني المستعار المشترَك هذا لإصدار رمز مميز لإعادة التحميل من أجل إجراء طلبات البيانات من واجهة برمجة التطبيقات.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
