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