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