العناوين البديلة المشتركة

عند العمل مع Google Ads API، يتم استخدام عناوين البريد الإلكتروني في أماكن متعددة لإدارة جهات الاتصال وإدارة إمكانية الوصول. وأهمها:

• عنوان البريد الإلكتروني لجهة الاتصال في Google Ads API: عناوين البريد الإلكتروني التي تم منحها دور المالك أو المحرِّر في مشروعك على Google Cloud، والتي تستخدمها Google لإرسال الإشعارات الإلزامية عن الخدمة والإشعارات الإدارية.
• عنوان البريد الإلكتروني لحساب Google Cloud Console: عنوان البريد الإلكتروني الذي يملك إذن وصول إداري إلى مشروع على السحابة الإلكترونية من Google المستخدَم لتطبيق OAuth 2.0.
• الوصول إلى الحساب الإداري على "إعلانات Google": حساب الخدمة (يُنصح به) أو العنوان البديل للبريد الإلكتروني المشترَك الذي يملك أذونات الوصول إلى الحسابات الإدارية على "إعلانات Google" التي يتم الوصول إليها من خلال Google Ads API.

ملاحظة: ننصح بشدة باستخدام حسابات الخدمة أو العناوين البديلة المشتركة للفرق بدلاً من عناوين البريد الإلكتروني الفردية للمستخدمين، وذلك لتجنُّب فقدان إمكانية الوصول إلى هذه الحسابات عندما يغيّر أعضاء الفريق فِرقهم أو يغادرون الشركة. يُرجى التأكّد من أنّ أي عنوان بديل للبريد الإلكتروني مشترك يُستخدم للمصادقة في Google Cloud أو "إعلانات Google" مرتبط بحساب Google نشط يمكنه تلقّي الرسائل الإلكترونية وإكمال عملية التحقّق من مفتاح المرور.

يتناول الجزء المتبقي من هذا الدليل بالتفصيل كل حساب من الحسابات المذكورة سابقًا وكيفية ضبطها لكي لا يعتمد التكامل على عنوان البريد الإلكتروني لمستخدم فردي.

عنوان البريد الإلكتروني لجهة الاتصال في Google Ads API

ترسل Google الإشعارات الإدارية وتعديلات مراجعة واجهة برمجة التطبيقات وطلبات التدقيق وإشعارات الخدمة الإلزامية (MSA) ومراسلات الطوارئ الخاصة بالإنتاج إلى عناوين البريد الإلكتروني المرتبطة بدورَي المالك والمحرِّر في مشروعك على Google Cloud (يُرجى الاطّلاع على عناوين البريد الإلكتروني الجديدة لجهات الاتصال في واجهة برمجة التطبيقات، لأنّ الإعداد القديم لعنوان البريد الإلكتروني لجهة الاتصال في مركز واجهة برمجة التطبيقات في واجهة مستخدم "إعلانات Google" قد تم إيقافه نهائيًا).

لتعديل عنوان البريد الإلكتروني المخصّص للتواصل وضمان تلقّي فريقك بأكمله هذه الإشعارات، يمكنك منح دور المالك أو المحرِّر لعنوان بريد إلكتروني بديل مشترك للفريق في مشروعك على Google Cloud ومتابعة الرسائل الإلكترونية المُرسَلة إلى هذا العنوان البديل بانتظام.

حساب Google Cloud Console

يحتوي مشروع Google Cloud Console على بيانات اعتماد OAuth الخاصة بتطبيقك ويتحكّم في الوصول إلى Google Ads API. يُرجى التأكّد من إمكانية الوصول إلى هذا المشروع من خلال منح عنوان بريد إلكتروني بديل لفريق مشترك دور المالك (أو المحرِّر).

اتّبِع الخطوات التالية لإضافة عنوان بديل مشترك كمالك مشروع على السحابة الإلكترونية على Google Cloud:

1. سجِّل الدخول إلى Google Cloud Console.
2. اختَر مشروعك من أداة اختيار المشاريع في أعلى الصفحة.
3. في قائمة التنقّل، انتقِل إلى إدارة الهوية وإمكانية الوصول والمشرف > إدارة الهوية وإمكانية الوصول.
4. انقر على منح إذن الوصول.
5. في قسم إضافة مستخدمين رئيسيين، أدخِل عنوان البريد الإلكتروني المشترَك في حقل المستخدمون الرئيسيون الجدد.
6. في قسم إسناد الأدوار، انقر على اختيار دور، واختَر أساسي > مالك (أو أساسي > محرِّر).
7. انقر على حفظ. إذا منحت دور المالك لعنوان بريد إلكتروني خارج مؤسستك على Google Cloud (أو لمشروع بدون مؤسسة)، ترسل Google Cloud دعوة بالبريد الإلكتروني إلى العنوان البديل المشترَك الذي يجب قبوله قبل أن يصبح الدور ساريًا. يمكنك الرجوع إلى مستندات Cloud لمعرفة المزيد حول منح وإلغاء الوصول.

حساب إداري على "إعلانات Google"

من الطرق الشائعة لإدارة الحسابات باستخدام Google Ads API هي ربط جميع حساباتك بحساب مدير مشترك، وإجراء طلبات بيانات من واجهة برمجة التطبيقات لجميع الحسابات باستخدام بيانات اعتماد حساب المدير الأعلى. في هذه الإعدادات، يضبط المطوّر عنوان الطلب login-customer-id (أو إعدادات ضبط مكتبة برامج login_customer_id) على رقم تعريف العميل المكوّن من 10 أرقام (بدون واصلات) للحساب الإداري على "إعلانات Google"، ويضبط customer_id المستهدَف على حساب التشغيل الذي يتم إجراء طلبات البيانات من واجهة برمجة التطبيقات إليه.

الإجراء المقترَح: استخدام حساب خدمة

يُعدّ استخدام حساب خدمة الطريقة المفضّلة للمصادقة والوصول إلى حساب إداري على "إعلانات Google". على عكس حسابات المستخدمين الفردية، تتم إدارة حساب الخدمة ضمن مشروعك على Google Cloud ولا يرتبط بشخص معيّن، ما يمنع حدوث انقطاعات في الخدمة عندما يغيّر أعضاء الفريق أدوارهم أو يغادرون الشركة. اتّبِع دليل حساب الخدمة لإنشاء حساب خدمة ومنحه إذن الوصول إلى حسابك الإداري على "إعلانات Google".

البديل: استخدام عنوان بديل للبريد الإلكتروني مشترَك

إذا لم يكن بإمكان عملية الدمج استخدام حساب خدمة وكانت تعتمد بدلاً من ذلك على سير عمل مصادقة المستخدم الواحد، يُصدر مستخدم لديه إذن الوصول إلى الحساب الإداري على "إعلانات Google" رمزًا مميزًا لإعادة التحميل في OAuth 2.0.

تنبيه: إذا فقد المستخدم المفوَّض إذن الوصول إلى الحساب الإداري على "إعلانات Google"، لن يعود الرمز المميز لإعادة التحميل صالحًا وستتعذّر على الفور جميع طلبات البيانات من واجهة برمجة التطبيقات.

لتجنُّب هذا السيناريو عند استخدام بيانات اعتماد المستخدم:

1. يمكنك دعوة العنوان البديل للبريد الإلكتروني المشترك (المرتبط بحساب Google نشط تم فيه تفعيل التحقّق باستخدام مفتاح المرور) لإدارة هذا الحساب الإداري على "إعلانات Google" من خلال مستويات الوصول المناسبة.
2. اقبل الدعوة باستخدام العنوان البديل المشترَك للبريد الإلكتروني.
3. استخدِم العنوان البديل للبريد الإلكتروني المشترَك هذا لإصدار الرمز المميّز لإعادة التحميل في OAuth من أجل إجراء طلبات بيانات من واجهة برمجة التطبيقات.