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

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

• البريد الإلكتروني لجهة اتصال Google Ads API: هذا هو عنوان البريد الإلكتروني الوارد كجهة الاتصال في مركز واجهة برمجة تطبيقات "إعلانات Google" بواجهة مستخدم "إعلانات 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 Ads API. وهذا هو الحساب ذاته الذي يوجد به الرمز المميز للمطوِّر.
• انتقِل إلى الأدوات والإعدادات > مركز واجهة برمجة التطبيقات.
• انقر على السهم الموجود أسفل قسم البريد الإلكتروني لجهة اتصال واجهة برمجة التطبيقات.
• عدِّل عنوان البريد الإلكتروني وانقر على الزر حفظ.

حساب Google Cloud Console

يحتوي مشروع وحدة تحكم واجهة برمجة تطبيقات Google على بيانات اعتماد OAuth لتطبيقك والتحكم في الوصول إلى Google Ads API. تأكد من الوصول إلى هذا الحساب من خلال جعل اسم مستعار مشترك هو صاحب الحساب.

اتبع هذه الخطوات لتحديث مالك مشروع وحدة تحكم واجهة برمجة تطبيقات Google:

• سجِّل الدخول إلى وحدة التحكم في واجهة Google API.
• حدد مشروعك من القائمة المنسدلة في أعلى الجانب الأيسر من الصفحة.
• انتقِل إلى IAM and admin (إدارة الهوية وإمكانية الوصول والمشرف) > IAM (إدارة الهوية وإمكانية الوصول) من القائمة اليمنى.
• انقر على الزر منح إذن الوصول.
• أدخِل عنوان البريد الإلكتروني المشترَك ضمن قسم إضافة رئيسيين.
• خصِّص دور المالك.
• انقر على الزر حفظ. يمكنك الرجوع إلى مستندات Cloud للاطّلاع على مزيد من المعلومات حول منح إذن الوصول وإبطاله.

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

من الطرق الشائعة لإدارة الحسابات باستخدام Google Ads API ربط جميع حساباتك ضمن حساب إداري مشترك، وإجراء طلبات بيانات من واجهة برمجة التطبيقات لجميع الحسابات باستخدام أعلى بيانات اعتماد للحساب الإداري. في هذه الإعدادات:

• يُصدر مطوّر البرامج رمزًا مميزًا لإعادة التحميل باستخدام بيانات اعتماد مستخدم لديه إمكانية الوصول إلى الحساب الإداري على "إعلانات Google".
• يضبط مطوّر البرامج عنوان login_customer_id على أنّه الرقم التعريفي للعميل للحساب الإداري على "إعلانات Google"، وعنوان customer_id على أنّه الرقم التعريفي للعميل للحساب الذي يتم إجراء طلبات البيانات من واجهة برمجة التطبيقات عليه.

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