یکپارچه‌سازی گوگل تقویم

پیش‌نیازها

• حساب Google Cloud Console
• دسترسی به Google Calendar API

ساخت پروژه در Google Cloud Console

1. به console.cloud.google.com بروید
2. پروژه جدیدی بسازید
3. از منوی «APIs & Services» ← «Library» وارد شوید
4. Google Calendar API را جستجو و فعال کنید

ساخت OAuth2 Credentials

1. «APIs & Services» ← «Credentials» ← «Create Credentials» ← «OAuth Client ID»
2. Application type: Web application
3. نام دلخواه وارد کنید
4. در «Authorized redirect URIs» آدرس callback اتصال کارمند را اضافه کنید. این آدرس برای هر کارمند شناسه‌ی او را در مسیر دارد:

   https://example.com/wp-json/pronobat/v1/staff/{staff_id}/gcal_oauth_callback
   

5. Client ID و Client Secret را کپی کنید

پیکربندی در نوبت

Client ID و Client Secret را در تنظیمات گوگل تقویم پرونوبت وارد کنید (کلیدهای google.client_id و google.client_secret).

پس از اتصال، پرونوبت هر دو رفتار زیر را انجام می‌دهد:

• بررسی مشغولیت (freebusy): بازه‌هایی که کارمند در تقویم گوگل مشغول است از لیست بازه‌های خالی حذف می‌شوند.
• ثبت رویداد: نوبت‌های جدید به‌عنوان رویداد در تقویم گوگل کارمند ساخته (و در لغو، حذف) می‌شوند.

اتصال حساب گوگل هر کارمند

1. به پرونوبت ← کارمندان بروید
2. کارمند موردنظر را باز کنید
3. در بخش «گوگل تقویم» روی اتصال به گوگل کلیک کنید
4. مراحل OAuth2 را در پاپ‌آپ طی کنید

هر کارمند می‌تواند تقویم جداگانه‌ای متصل کند.

نحوه همگام‌سازی

• نوبت جدید: یک رویداد در تقویم گوگل کارمند ساخته می‌شود
• لغو نوبت: رویداد از تقویم حذف می‌شود
• نوبت شخصی کارمند در گوگل: آن بازه زمانی در نوبت به‌عنوان مشغول نشان داده می‌شود