عند العمل مع 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 Ads API. يجب التأكّد من إمكانية الوصول إلى هذا الاسم المعرِّف ومراقبة الرسائل الإلكترونية المُرسَلة إلى هذا العنوان بانتظام. تستخدم Google عنوان البريد الإلكتروني هذا للتواصل مع فريقك أثناء عمليات مراجعة واجهة برمجة التطبيقات أو طلبات التدقيق أو حالات الطوارئ المتعلقة بالإصدارات التي تتطلّب الانتباه الفوري. استخدِم عنوان بريد إلكتروني بديلاً مشترَكًا للفريق كعنوان البريد الإلكتروني المخصّص للتواصل لضمان تلقّي الفريق بأكمله لهذه الإشعارات.
اتّبِع الخطوات التالية لتعديل عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات:
سجِّل الدخول إلى حسابك الإداري على "إعلانات Google".
انقر على المشرف في أسفل يمين الشاشة.
ضمن إعدادات حساب المدير، انقر على مركز واجهة برمجة التطبيقات.
ضمن تفاصيل المطوّر، دوِّن عنوان البريد الإلكتروني المخصّص للتواصل بشأن واجهة برمجة التطبيقات. انقر على السهم المتّجه للأسفل وعدِّل الرسالة الإلكترونية. انقر على حفظ.
حساب Google Cloud Console
يحتوي مشروع وحدة تحكّم واجهة برمجة التطبيقات في Google على بيانات اعتماد OAuth لتطبيقك ويتحكم في الوصول إلى Google Ads API. تأكَّد من إمكانية الوصول إلى هذا الحساب من خلال منح مالك الحساب اسمًا بديلاً مشترَكًا.
اتّبِع الخطوات التالية لتعديل مالك مشروع Google API Console:
- سجِّل الدخول إلى وحدة تحكّم واجهة برمجة التطبيقات في Google.
- اختَر مشروعك من القائمة المنسدلة في أعلى يمين الصفحة.
- انتقِل إلى إدارة الهوية وإمكانية الوصول والمشرف > إدارة الهوية وإمكانية الوصول من القائمة اليمنى.
- انقر على الزر منح إذن الوصول.
- أدخِل عنوان البريد الإلكتروني المشترَك ضمن قسم إضافة عناصر أساسية.
- أسنِد دور المالك.
- انقر على الزر حفظ. راجِع مستندات Cloud للاطّلاع على مزيد من المعلومات عن منح إذن الوصول وإبطاله.
حساب إداري على "إعلانات Google"
من الطرق الشائعة لإدارة الحسابات باستخدام Google Ads API هي ربط كل حساباتك ضمن حساب إداري شائع، وإجراء طلبات بيانات من واجهة برمجة التطبيقات إلى كل الحسابات باستخدام بيانات اعتماد الحساب الإداري الأعلى. في هذه الإعدادات:
- يُصدِر المطوّر رمزًا مميزًا لإعادة التحميل باستخدام بيانات اعتماد مستخدم لديه إذن بالوصول إلى الحساب الإداري على "إعلانات Google".
- يضبط المطوّر رأس
login_customer_id
على أنّه العميل الرقم التعريفي للحساب الإداري على "إعلانات Google"، ويضبط رأسcustomer_id
على أنّه العميل الرقم التعريفي للحساب الذي يتم إجراء طلبات البيانات من واجهة برمجة التطبيقات إليه.
من بين المخاطر المحتملة لهذا الإعداد أنّه في حال فقدان المستخدم المفوَّض إمكانية الوصول إلى حساب مدير "إعلانات Google"، لن يعود رمز إعادة التنشيط صالحًا وستتعطّل جميع طلبات بيانات واجهة برمجة التطبيقات. لتجنّب هذا السيناريو، يمكنك دعوة عنوان بريد إلكتروني بديل مشترَك ليقوم بإدارة هذا الحساب الإداري على "إعلانات Google" باستخدام مستويات الوصول المناسبة. استخدِم الاسم المعرِّف المشترَك للبريد الإلكتروني هذا لإصدار الرمز المميّز لإعادة التحميل لإجراء طلبات البيانات من واجهة برمجة التطبيقات.