قم بتوصيل Gmail بـ Odoo باستخدام Google OAuth¶

Odoo متوافق مع بروتوكول OAuth من Google لـ Gmail. لإرسال رسائل بريد إلكتروني آمنة من نطاق مخصص، كل ما هو مطلوب هو تكوين بعض الإعدادات على منصة Workspace الخاصة بـ Google، وكذلك على الواجهة الخلفية لقاعدة بيانات Odoo. يعمل هذا التكوين باستخدام إما عنوان بريد إلكتروني شخصي أو عنوان تم إنشاؤه بواسطة مجال مخصص.

نصيحة

لمزيد من المعلومات، تفضل بزيارة وثائق Google حول إعداد OAuth.

الإعداد في جوجل¶

إنشاء مشروع جديد¶

للبدء، انتقل إلى Google API Console. قم بتسجيل الدخول باستخدام حساب Google Workspace الخاص بك إذا كان لديك حسابًا، وإلا قم بتسجيل الدخول باستخدام حساب Gmail الشخصي الخاص بك (يجب أن يتطابق هذا مع عنوان البريد الإلكتروني الذي تريد تكوينه في Odoo).

بعد ذلك، انقر على Create Project، الموجود في أقصى يمين شاشة موافقة OAuth. إذا تم إنشاء مشروع بالفعل في هذا الحساب، فسيكون خيار New Project موجودًا في الجزء العلوي الأيمن ضمن القائمة المنسدلة Select a project.

في شاشة مشروع جديد، أعد تسمية اسم المشروع إلى Odoo واستعرض بحثًا عن Location. قم بتعيين Location باعتباره مؤسسة Google Workspace. إذا كنت تستخدم حساب Gmail شخصيًا، فاترك Location كـ No Organization.

انقر على إنشاء لإنهاء هذه الخطوة.

تحرير تسجيل التطبيق¶

بعد ذلك سنقوم بتكوين تسجيل التطبيق للمشروع.

في خطوة شاشة موافقة OAuth، ضمن القسم معلومات التطبيق، أدخل`Odoo` في الحقل اسم التطبيق. حدد عنوان البريد الإلكتروني للمؤسسة ضمن حقل البريد الإلكتروني User support.

بعد ذلك، ضمن App Domain ‣ Authorized domains، انقر على Add Domain وأدخل odoo.com.

بعد ذلك، ضمن قسم معلومات الاتصال بالمطور، أدخل عنوان البريد الإلكتروني للمؤسسة. تستخدم Google عنوان البريد الإلكتروني هذا لإعلام المؤسسة بأي تغييرات تطرأ على مشروعك.

بعد ذلك، انقر فوق الزر حفظ ومتابعة. بعد ذلك، قم بتخطي صفحة Scopes بالتمرير إلى الأسفل والنقر على Save and continue.

في حالة الاستمرار في وضع الاختبار (خارجي)، أضف عناوين البريد الإلكتروني التي تم تكوينها ضمن خطوة اختبار المستخدمين، بالنقر فوق إضافة مستخدمين، ثم الزر حفظ ومتابعة. يظهر ملخص تسجيل التطبيق.

أخيرًا، قم بالتمرير إلى الأسفل وانقر على Back to Dashboard لإنهاء إعداد المشروع.

إنشاء بيانات الاعتماد¶

الآن بعد أن تم إعداد المشروع، يجب إنشاء بيانات الاعتماد، والتي تتضمن معرف العميل و*سر العميل*. أولاً، انقر على Credentials في قائمة الشريط الجانبي الأيسر.

بعد ذلك، انقر فوق إنشاء بيانات الاعتماد في القائمة العلوية وحدد معرف عميل OAuth من القائمة المنسدلة.

ضمن Application Type، حدد Web Application من القائمة المنسدلة.
في الحقل Name، أدخل Odoo.
ضمن التصنيف محددات URI لإعادة التوجيه المعتمدة، انقر فوق الزر ADD URI، ثم أدخل https://yourdbname.odoo.com/google_gmail/confirm في URIs 1 مجال. تأكد من استبدال الجزء yourdbname من عنوان URL بالاسم الفعلي لقاعدة بيانات Odoo.
بعد ذلك، انقر فوق إنشاء لإنشاء OAuth معرف العميل و:guilabel:سر العميل. أخيرًا، انسخ كل قيمة تم إنشاؤها لاستخدامها لاحقًا عند التكوين في Odoo، ثم انتقل إلى قاعدة بيانات Odoo.

الإعداد في أودو¶

أدخل بيانات اعتماد جوجل¶

أولاً، افتح Odoo وانتقل إلى وحدة Apps. بعد ذلك، قم بإزالة مرشح Apps من شريط البحث واكتب Google. قم بتثبيت الوحدة المسماة Google Gmail.

بعد ذلك، انتقل إلى الإعدادات ‣ الإعدادات العامة، وضمن القسم Discuss، تأكد من تحديد مربع الاختيار لـ Custom Email Servers أو External Email Servers. التحقق. يؤدي هذا إلى ملء خيار جديد لـ بيانات اعتماد Gmail أو استخدام Gmail Sever. بعد ذلك، انسخ القيم المعنية والصقها في الحقلين Client ID و:guilabel:Client Secret و:guilabel:Save الإعدادات.

تكوين خادم البريد الإلكتروني الصادر¶

لتكوين حساب Gmail الخارجي، ارجع إلى أعلى إعداد Custom Email Servers، ثم انقر فوق الرابط Outgoing Email Servers.

تكوين خوادم البريد الإلكتروني الصادرة في Odoo.

بعد ذلك، انقر فوق New أو Create لإنشاء خادم بريد إلكتروني جديد، واملأ Name، Description، والبريد الإلكتروني:guilabel:`Username `(إذا لزم الأمر).

بعد ذلك، انقر على Gmail OAuth Authentication أو Gmail (ضمن قسم Authenticate with أو الاتصال). وأخيرًا، انقر على Connect your Gmail Account.

يتم فتح نافذة جديدة تحمل اسم Google لإكمال عملية التفويض. حدد عنوان البريد الإلكتروني المناسب الذي تم تكوينه في Odoo.

إذا كان عنوان البريد الإلكتروني حسابًا شخصيًا، فستنبثق خطوة إضافية، لذا انقر فوق متابعة للسماح بالتحقق وربط حساب Gmail بـ Odoo.

بعد ذلك، اسمح لـ Odoo بالوصول إلى حساب Google من خلال النقر على متابعة أو السماح. بعد ذلك، تنتقل الصفحة مرة أخرى إلى خادم البريد الإلكتروني الصادر الذي تم تكوينه حديثًا في Odoo. يقوم التكوين تلقائيًا بتحميل الرمز المميز في Odoo، وتظهر علامة تنص على:guilabel:Gmail Token Valid باللون الأخضر.

أخيرًا، اختبار الاتصال. يجب أن تظهر رسالة تأكيد. يمكن لقاعدة بيانات Odoo الآن إرسال رسائل بريد إلكتروني آمنة عبر Google باستخدام مصادقة OAuth.

الأسئلة الشائعة حول Google OAuth¶

الإنتاج مقابل اختبار حالة النشر¶

سيؤدي اختيار Production كـ Publishing Status (بدلاً من Testing) إلى عرض رسالة التحذير التالية:

يقتصر OAuth على 100 عملية تسجيل دخول للنطاق الحساس.

لتصحيح هذا التحذير، انتقل إلى Google API Platform. إذا كانت حالة النشر هي:guilabel:قيد الإنتاج، فانقر على الرجوع إلى الاختبار لتصحيح المشكلة.

لم تتم إضافة أي مستخدمين للاختبار¶

إذا لم تتم إضافة أي مستخدمين اختباريين إلى شاشة موافقة OAuth، فسيتم ظهور خطأ رفض الوصول 403.

لتصحيح هذا الخطأ، ارجع إلى شاشة موافقة OAuth ضمن APIs & Services وأضف مستخدمًا (مستخدمين) اختباريًا إلى التطبيق. أضف البريد الإلكتروني الذي تقوم بتكوينه في Odoo.

لم يتم تحديث وحدة Gmail¶

إذا لم يتم تحديث وحدة Google Gmail في Odoo إلى الإصدار الأحدث، فستظهر رسالة الخطأ Forbidden.

محظور ليس لديك الإذن للوصول إلى المورد المطلوب.

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

نوع التطبيق¶

عند إنشاء بيانات الاعتماد (OAuth معرف العميل و*سر العميل*)، إذا تم تحديد Desktop App لـ Application Type، فسيظهر Authorization Error.

لتصحيح هذا الخطأ، احذف بيانات الاعتماد التي تم إنشاؤها بالفعل وأنشئ بيانات اعتماد جديدة، مع تحديد Web Application لـ Application Type. بعد ذلك، ضمن Authorized Redirect URIs، انقر فوق ADD URI واكتب: https://yourdbname.odoo.com/google_gmail/confirm في الحقل، مع التأكد من استبدال yourdbname في عنوان URL الذي يحمل اسم قاعدة بيانات Odoo.