هماهنگ‌سازی تقویم گوگل با اودوو

تقویم گوگل را با اودوو هماهنگ کنید تا بتوانید جلسات را در هر دو پلتفرم مشاهده و مدیریت کنید (بروزرسانی‌ها به صورت دوطرفه انجام می‌شود). این یکپارچگی به تنظیم برنامه‌ها کمک می‌کند تا هیچ جلسه‌ای از دست نرود.

تنظیمات در گوگل

انتخاب (یا ایجاد) یک پروژه

یک پروژه جدید API گوگل ایجاد کنید و API تقویم گوگل را فعال کنید. ابتدا به کنسول API گوگل مراجعه کرده و به حساب کاربری گوگل خود وارد شوید.

توجه

اگر اولین بار است که به این صفحه مراجعه می‌کنید، گوگل از شما می‌خواهد که یک کشور را انتخاب کرده و با شرایط خدمات موافقت کنید. یک کشور را از لیست کشویی انتخاب کرده و با ToS موافقت کنید.

سپس، روی Select a project کلیک کرده و یک پروژه API را برای پیکربندی OAuth انتخاب (یا ایجاد) کنید و اطلاعات دسترسی را ذخیره کنید. روی New Project کلیک کنید.

نکته

یک نام واضح مانند "همگام‌سازی اودوو" برای پروژه API انتخاب کنید تا به راحتی شناسایی شود.

فعال کردن API تقویم گوگل

اکنون، در منوی سمت چپ روی Enabled APIs and Services کلیک کنید. اگر نوار جستجو ظاهر نمی‌شود، دوباره Enabled APIs and Services را انتخاب کنید.

سپس با استفاده از نوار جستجو، Google Calendar API را جستجو کرده و از نتایج جستجو Google Calendar API را انتخاب کنید. روی Enable کلیک کنید.

صفحه تأیید OAuth

اکنون که پروژه API ایجاد شده است، باید OAuth پیکربندی شود. برای این کار، روی OAuth consent در منوی سمت چپ کلیک کنید و سپس نوع کاربر را انتخاب کنید.

هشدار

حساب‌های جیمیل شخصی فقط مجاز به استفاده از نوع کاربری خارجی هستند، به این معنا که گوگل ممکن است تأییدیه‌ای بخواهد یا نیاز به افزودن محدوده‌ها باشد. با این حال، استفاده از یک حساب Google WorkSpace اجازه می‌دهد از نوع کاربری داخلی استفاده شود.

توجه داشته باشید که در حالی که اتصال API در حالت آزمایشی خارجی است، نیازی به تأیید از طرف گوگل نیست. محدودیت کاربران در این حالت آزمایشی به 100 کاربر تنظیم شده است.

در مرحله دوم، صفحه تأیید OAuth، Odoo را در فیلد نام اپلیکیشن تایپ کنید، آدرس ایمیل را برای فیلد ایمیل پشتیبانی کاربر انتخاب کنید و آدرس ایمیل را برای بخش اطلاعات تماس توسعه‌دهنده وارد کنید. سپس روی ذخیره و ادامه کلیک کنید.

مرحله سوم، محدوده‌ها را با کلیک روی ذخیره و ادامه رد کنید.

سپس، اگر در حالت آزمایشی (خارجی) ادامه می‌دهید، آدرس‌های ایمیلی که پیکربندی می‌شوند را در مرحله کاربران آزمایشی اضافه کنید، با کلیک روی افزودن کاربران و سپس دکمه ذخیره و ادامه. خلاصه‌ای از ثبت اپلیکیشن نمایش داده می‌شود.

در نهایت، به پایین صفحه بروید و روی بازگشت به داشبورد کلیک کنید.

اکنون تأیید OAuth پیکربندی شده است و زمان ایجاد اطلاعات دسترسی فرا رسیده است.

ایجاد اطلاعات دسترسی

برای اتصال تقویم گوگل به اودوو، به شناسه مشتری (Client ID) و رمز مشتری (Client Secret) نیاز دارید. این آخرین مرحله در کنسول گوگل است. ابتدا روی Credentials در منوی سمت چپ کلیک کنید. سپس، روی Create Credentials کلیک کرده و OAuth client ID را انتخاب کنید. گوگل یک راهنما برای ایجاد اطلاعات دسترسی باز می‌کند.

در ایجاد شناسه مشتری OAuth، برای فیلد نوع اپلیکیشن گزینه اپلیکیشن وب‌سایت را انتخاب کنید و برای نام عبارت My Odoo Database را وارد کنید.

• در بخش ریشه‌های مجاز جاوااسکریپت روی + Add URI کلیک کنید و آدرس کامل URL شرکت برای اودوو را وارد کنید.

• در بخش نشانی‌های بازگشت مجاز روی + Add URI کلیک کنید و آدرس URL شرکت برای اودوو را با افزودن /google_account/authentication وارد کنید. در نهایت، روی Create کلیک کنید.

یک شناسه مشتری و یک رمز مشتری ظاهر می‌شود؛ آنها را در یک دفترچه یادداشت کپی کنید.

تنظیم در اودوو

پس از یافتن شناسه مشتری (Client ID) و رمز مشتری (Client Secret)، پایگاه داده اودوو را باز کنید و به تنظیمات ‣ تنظیمات عمومی ‣ یکپارچگی‌ها ‣ تقویم گوگل بروید. تیک کنار تقویم گوگل را فعال کنید.

سپس، شناسه مشتری (Client ID) و رمز مشتری (Client Secret) را از صفحه اطلاعات دسترسی API تقویم گوگل کپی کرده و در فیلدهای مربوطه زیر کادر تقویم گوگل قرار دهید. سپس روی ذخیره کلیک کنید.

همگام‌سازی تقویم در اودوو

در نهایت، اپلیکیشن تقویم را در اودوو باز کرده و روی دکمه همگام‌سازی گوگل کلیک کنید تا تقویم گوگل با اودوو همگام‌سازی شود.

توجه

هنگام همگام‌سازی تقویم گوگل با اودوو برای اولین بار، صفحه به حساب گوگل هدایت می‌شود. از آنجا، حساب ایمیل`ی که باید دسترسی داشته باشد را انتخاب کنید، سپس :guilabel:`ادامه (اگر برنامه تأیید نشده باشد) و در نهایت ادامه (برای دادن مجوز انتقال داده‌ها) را انتخاب کنید.

اکنون تقویم اودوو با موفقیت با تقویم گوگل همگام‌سازی شده است!

هشدار

اودوو اکیداً توصیه می‌کند که همگام‌سازی تقویم گوگل را ابتدا در یک پایگاه داده آزمایشی و یک آدرس ایمیل آزمایشی (که برای هیچ منظور دیگری استفاده نمی‌شود) امتحان کنید، قبل از اینکه تقویم گوگل مورد نظر را با پایگاه داده تولید کاربر همگام‌سازی کنید.

هنگامی که کاربر تقویم گوگل خود را با تقویم اودوو همگام‌سازی می‌کند:

• ایجاد یک رویداد در اودوو باعث می‌شود گوگل دعوتنامه‌ای به تمام شرکت‌کنندگان رویداد ارسال کند.

• حذف یک رویداد در اودوو باعث می‌شود گوگل یک اعلان لغو برای تمام شرکت‌کنندگان رویداد ارسال کند.

• اضافه کردن یک مخاطب به یک رویداد باعث می‌شود گوگل دعوتنامه‌ای به تمام شرکت‌کنندگان رویداد ارسال کند.

• حذف یک مخاطب از یک رویداد باعث می‌شود گوگل یک اعلان لغو برای تمام شرکت‌کنندگان رویداد ارسال کند.

رویدادها می‌توانند در تقویم گوگل بدون ارسال اعلان ایجاد شوند، با انتخاب گزینه ارسال نکنید زمانی که سیستم از شما درخواست ارسال ایمیل دعوتنامه می‌کند.

رفع مشکل همگام‌سازی

گاهی ممکن است حساب تقویم گوگل به درستی با اودوو همگام‌سازی نشود. مشکلات همگام‌سازی را می‌توان در گزارش‌های پایگاه داده مشاهده کرد.

در این موارد، نیاز به عیب‌یابی حساب وجود دارد. می‌توانید با استفاده از دکمه بازنشانی حساب که از طریق اپلیکیشن تنظیمات ‣ مدیریت کاربران قابل دسترسی است، این کار را انجام دهید. سپس، کاربری را که قصد تغییر تقویم آن را دارید انتخاب کرده و روی زبانه تقویم کلیک کنید.

سپس، زیر تقویم صحیح روی بازنشانی حساب کلیک کنید.

گزینه‌های بازنشانی

گزینه‌های بازنشانی زیر برای عیب‌یابی همگام‌سازی تقویم گوگل با اودوو در دسترس هستند:

رویدادهای موجود کاربر:

• بدون تغییر: هیچ تغییری در رویدادها ایجاد نشود.

• حذف از حساب فعلی تقویم گوگل: رویدادها از تقویم گوگل حذف شوند.

• حذف از اودوو: رویدادها از تقویم اودوو حذف شوند.

• حذف از هر دو: رویدادها از تقویم گوگل و تقویم اودوو حذف شوند.

همگام‌سازی بعدی:

• فقط رویدادهای جدید را همگام‌سازی کنید: رویدادهای جدید در تقویم گوگل و/یا تقویم اودوو همگام‌سازی شوند.

• همگام‌سازی تمام رویدادهای موجود: تمام رویدادها در تقویم گوگل و/یا تقویم اودوو همگام‌سازی شوند.

پس از انجام انتخاب، برای تغییر رویدادهای کاربر و همگام‌سازی تقویم روی تأیید کلیک کنید.

پرسش‌های متداول درباره Google OAuth

گاهی ممکن است پیکربندی نادرستی انجام شود و نیاز به عیب‌یابی برای حل مشکل باشد. در زیر، رایج‌ترین خطاهایی که ممکن است هنگام پیکربندی تقویم گوگل برای استفاده با اودوو رخ دهد، آمده است.

وضعیت انتشار تولید در مقابل آزمایش

انتخاب تولید به عنوان وضعیت انتشار (به جای آزمایش) پیام هشدار زیر را نمایش می‌دهد:

OAuth به 100 ورود در محدوده حساس محدود می‌شود تا زمانی که صفحه تأیید OAuth تأیید شود. این ممکن است به فرآیند تأییدی نیاز داشته باشد که چند روز طول بکشد.

برای رفع این هشدار، به پلتفرم API گوگل بروید. اگر وضعیت انتشار روی در تولید باشد، روی بازگشت به آزمایش کلیک کنید تا مشکل برطرف شود.

هیچ کاربر آزمایشی اضافه نشده است.

اگر هیچ کاربر آزمایشی به صفحه تأیید OAuth اضافه نشده باشد، یک خطای 403: دسترسی ممنوع ظاهر می‌شود.

برای رفع این خطا، به صفحه تأیید OAuth، در بخش APIها و خدمات بازگردید و کاربران آزمایشی را به برنامه اضافه کنید. ایمیلی را که قرار است در اودوو پیکربندی شود اضافه کنید.

نوع اپلیکیشن

هنگام ایجاد اطلاعات دسترسی (شناسه مشتری OAuth و رمز مشتری)، اگر اپلیکیشن دسکتاپ به عنوان نوع اپلیکیشن انتخاب شود، یک خطای مجوز ظاهر می‌شود (خطای 400: عدم تطابق آدرس بازگشت).

برای رفع این خطا، اطلاعات دسترسی موجود را حذف کرده و اطلاعات جدیدی ایجاد کنید، با انتخاب اپلیکیشن وب به عنوان نوع اپلیکیشن.

سپس، در بخش آدرس‌های بازگشت مجاز، روی افزودن URI کلیک کنید و عبارت https://yourdbname.odoo.com/google_account/authentication را وارد کنید، و مطمئن شوید که yourdbname در URL با نام واقعی پایگاه داده اودوو جایگزین شده باشد.

نکته

اطمینان حاصل کنید که دامنه (استفاده شده در URI: https://yourdbname.odoo.com/google_account/authentication) دقیقاً همان دامنه‌ای است که در پارامتر سیستم web.base.url پیکربندی شده است.

با فعال کردن حالت توسعه‌دهنده به web.base.url دسترسی پیدا کنید و به اپلیکیشن تنظیمات ‣ منوی هدر فنی ‣ بخش پارامترها ‣ پارامترهای سیستم بروید.