Google Calendar جوڑیں
یہ گائیڈ دکھاتی ہے کہ Google Calendar کو workspace سے کیسے جوڑیں۔ یہ ہر workspace اور ہر رکن کے لیے ہے: یہ اس workspace کے لیے آپ کے events کو Control Center میں sync کرتا ہے، جہاں آپ دعوت ناموں کا جواب دے سکتے ہیں، نئے events بُک، منتقل اور حذف کر سکتے ہیں۔ پوری تصویر کے لیے دیکھیں کیلنڈر اور شیڈولنگ۔
پیشگی شرائط
سیکشن کا عنوان “پیشگی شرائط”- سرور لوگوں کو Google میں sign in کرا سکے: یا Control Center Connect کے ذریعے، یا سرور کے اپنے Google client کے ساتھ (اپنا Google client لائیں)۔ سرور کا مالک ترتیبات → سرور → سنگل سائن آن میں انتخاب کرتا ہے
- ایک workspace کھلا ہو: calendar account ہمیشہ ایک workspace سے تعلق رکھتا ہے
ایک account جوڑنا
سیکشن کا عنوان “ایک account جوڑنا”- سائیڈ بار میں کیلنڈر کھولیں۔
- calendar سائیڈ بار میں کیلنڈر اکاؤنٹ شامل کریں پر کلک کریں۔ (یہی حصہ ترتیبات → آپ → پروفائل کے تحت Google Calendar میں بھی ہے۔)
- Google Calendar منسلک کریں پر کلک کریں۔ آپ کا براؤزر Google کا consent page کھولتا ہے۔
- account چنیں اور اپنے calendar events اور calendar list تک رسائی کی منظوری دیں۔
یہ کیسے ختم ہوتا ہے، اس کا انحصار اس پر ہے کہ sign-in کون چلا رہا ہے:
- سرور کا اپنا Google client: Google آپ کے براؤزر کو سرور پر واپس بھیجتا ہے اور dialog خودبخود بند ہو جاتا ہے
- Control Center Connect: براؤزر کا صفحہ ایک 8 حروف کا کوڈ دکھاتا ہے۔ اسے dialog میں ٹائپ کریں، یا براؤزر کو
control-center://لنک کے ذریعے Control Center کھولنے دیں اور ٹائپ کرنے سے بچیں
آپ کے events فوراً sync ہونا شروع ہو جاتے ہیں۔ تبادلہ آپ کا آلہ نہیں، سرور مکمل کرتا ہے، اور credential وہی رکھتا ہے۔
account صرف فعال workspace سے جڑتا ہے، اور وہ آپ کا ہے: دو ارکان جو ایک ہی Google پتہ جوڑیں ان کے الگ accounts بنتے ہیں۔ workspace بدلیں تو اسی workspace کے calendars نظر آتے ہیں۔
connect flow ہر client کے ساتھ calendar.events اور calendar.calendarlist.readonly کے ساتھ openid email کی درخواست کرتا ہے۔ وہ account جو Control Center کے Google پر لکھنے سے پہلے جوڑا گیا ہو صرف read scope رکھتا ہے؛ وہ آپ سے دوبارہ جوڑنے کو کہتا ہے، اور نیا sign-in باقی دے دیتا ہے۔
events بُک کریں، منتقل کریں، جواب دیں اور حذف کریں
سیکشن کا عنوان “events بُک کریں، منتقل کریں، جواب دیں اور حذف کریں”- event بُک کریں: ہفتے یا دن کے view میں time grid پر ڈریگ کر کے وقفہ بنائیں (month view میں پورے دن کے event کے لیے دنوں پر ڈریگ کریں)۔ ساتھ ایک کارڈ کھلتا ہے جس میں عنوان، اوقات، مہمان، Google Meet لنک، مقام، تفصیل اور وہ calendar ہوتا ہے جس پر بُک کرنا ہے۔ محفوظ کریں اسے Google پر بُک کرتا ہے اور کھول دیتا ہے۔ calendar header کا + بٹن اگلے خالی quarter hour کے لیے یہی کارڈ کھولتا ہے۔ منسوخ کرنے کے لیے Escape دبائیں
- event منتقل کریں: اسے کسی اور وقت یا دن پر ڈریگ کریں، یا اس کے نچلے کنارے کو ڈریگ کر کے اختتام کا وقت بدلیں۔ Google کے نیا وقت قبول کرنے پر یہ کھلتا ہے؛ اگر Google انکار کرے تو یہ واپس اپنی جگہ پر چلا جاتا ہے۔ آپ اپنے events اور وہ events جنہیں آپ منظم کرتے ہیں منتقل کر سکتے ہیں؛ دعوت نامہ وہیں رہتا ہے جہاں منظم کرنے والے نے رکھا ہو
- دعوت نامے کا جواب دیں: event کھولیں اور ہاں، شاید یا نہیں چنیں
- event حذف کریں: event کھولیں اور ٹرَش آئیکن پر کلک کریں۔ تصدیق بتاتی ہے کہ کون متاثر ہوگا: مہمانوں کو بتایا جاتا ہے کہ جو event آپ منظم کرتے ہیں وہ منسوخ ہو گیا، جبکہ دعوت حذف کرنے سے وہ صرف آپ کے calendar سے ہٹتی ہے۔ recurring event کے ایک occurrence کو حذف کرنے سے باقی سلسلہ برقرار رہتا ہے
مہمانوں کو Google کی اپنی ای میل دعوت، اپڈیٹ یا منسوخی ملتی ہے۔ آپ صرف ان calendars پر بُک کر سکتے ہیں جن میں آپ کا account لکھ سکتا ہے، اور صرف اپنے accounts کے ساتھ: کسی دوسرے رکن کا جڑا ہوا calendar کبھی پیش نہیں کیا جاتا۔ recurring event کے ایک occurrence کو منتقل کرنے سے بھی باقی سلسلہ برقرار رہتا ہے۔
sync کیسے کام کرتا ہے
سیکشن کا عنوان “sync کیسے کام کرتا ہے”سرور شیڈول کا مالک ہے: وہ ہر workspace کے جڑے ہوئے accounts کو ہر دو منٹ بعد دیکھتا ہے اور events کو workspace کے database میں لکھتا ہے۔ کلائنٹس کبھی Google سے بات نہیں کرتے — وہ وہی پڑھتے ہیں جو سرور نے لکھا ہے۔
بررسی افزائشی ہے۔ ہر calendar کا پہلا گزر ایک متحرک window (60 دن پیچھے، 90 دن آگے) لیتا ہے اور Google کا sync token محفوظ کرتا ہے؛ بعد کے گزرے وہ token پیش کرتے ہیں اور صرف تبدیلیاں وصول کرتے ہیں، اور یہی دو منٹ کے وقفے کو مقرون بہ صرفہ بناتا ہے۔ window ہر 24 گھنٹے بعد پورے sync سے دوبارہ لنگر ہوتی ہے اور جب بھی Google token کو باطل کرے۔
اعتبارنامے سرور کی جانب secrets.json میں، سرور کی data directory کے تحت محفوظ رہتے ہیں، صرف مالک کے لیے لکھے جانے والے (0600) — OS keychain میں نہیں اور کبھی کلائنٹ آلے پر نہیں۔ Connect کے ذریعے sign-in صرف ایک sealed credential محفوظ کرتا ہے جسے Connect صرف اسی سرور کے لیے کھول سکتا ہے؛ اس کا access token سرور کی memory میں رہتا ہے۔
کئی accounts جوڑنا
سیکشن کا عنوان “کئی accounts جوڑنا”ایک workspace کئی Google accounts جوڑ سکتا ہے (مثلاً کام اور ذاتی)۔ ہر ایک کے لیے connect کا مرحلہ دہرائیں؛ ان کے events ایک ہی month / week / agenda views میں ضم ہو جاتے ہیں۔ ہر account آزادانہ sync اور refresh ہوتا ہے اور ہر ایک کو الگ سے disconnect کیا جا سکتا ہے۔
منقضی account کو دوبارہ جوڑنا
سیکشن کا عنوان “منقضی account کو دوبارہ جوڑنا”اگر Google کسی account کے sign-in کو مستقل طور پر باطل کر دے (منسوخ یا بہت پرانا session)، تو sync رک جاتا ہے اور Control Center calendar پر ایک دوبارہ منسلک کریں بینر دکھاتا ہے، ساتھ میں desktop notification بھی۔ دوبارہ منسلک کریں پر کلک کریں اور دوبارہ sign in کریں؛ بینر اگلے کامیاب sync پر غائب ہو جاتا ہے۔
یہی بینر اس وقت بھی ظاہر ہوتا ہے جب یہ سرور اس sign-in کو مزید استعمال نہ کر سکے: سرور کے مالک نے Connect سرورز بدلے یا Connect key rotate کی، سرور کا اپنا Google client بدل گیا، یا data directory کسی اور مشین پر بحال کی گئی۔
account کو disconnect کرنا
سیکشن کا عنوان “account کو disconnect کرنا”calendar سائیڈ بار سے (یا ترتیبات → آپ → پروفائل سے) اس account پر منقطع کریں پر کلک کریں۔ اس سے اس کے sync شدہ events حذف ہو جاتے ہیں اور سرور پر اس کا محفوظ credential صاف ہو جاتا ہے۔
اپنا Google client لائیں
سیکشن کا عنوان “اپنا Google client لائیں”جب آپ اپنی ایپس استعمال کریں چنیں تو اپنا Google client چلائیں۔ سرور کا client صرف تب لاگو ہوتا ہے: Control Center Connect یا custom Connect کے ساتھ، Connect ہر lane چلاتا ہے، Google سمیت، اور سرور کا client محفوظ رہتا ہے مگر استعمال نہیں ہوتا۔ جب سرور Connect استعمال کر رہا ہو اور consent screen پر آپ کے اپنے پروجیکٹ کا نام ہو، تو workspace کو اپنی ایپس پر رکھیں اور اسے اپنا client دیں (یہاں دیکھیں)؛ یہ سرور کے کسی بھی mode میں لاگو ہوتا ہے۔
- Google Cloud Console میں Google Calendar API فعال کریں اور OAuth consent screen ترتیب دیں، جس میں
calendar.events،calendar.calendarlist.readonly،openidاورemailscopes شامل ہوں۔ جب تک app verify نہ ہو، خود کو test user کے طور پر شامل کریں۔ - Web application قسم کا ایک OAuth client ID بنائیں۔
- مجاز redirect URI
<server origin>/oauth/google/callbackشامل کریں۔ ترتیبات → سرور → سنگل سائن آن → فراہم کنندہ ایپس → Google درست URL کال بیک URLs کے تحت دکھاتا ہے؛ اسے ہو بہو کاپی کریں۔ - Client id اور Client secret اسی Google بلاک میں چسپاں کریں، یا انہیں سرور کی
.envفائل میںGOOGLE_OAUTH_CLIENT_IDاورGOOGLE_OAUTH_CLIENT_SECRETکے طور پر رکھیں۔
سرور اس وقت شروع ہونے سے انکار کرتا ہے جب GOOGLE_OAUTH_CLIENT_SECRET اس کے پروسیس ماحول میں ایکسپورٹ ہو؛ اسے .env فائل میں رکھیں (Docker میں، اسے /app/bin/.env پر mount کریں)۔ راز کبھی سرور سے باہر نہیں جاتا: کوئی RPC response اسے نہیں لے کر جاتا۔ بغیر secret کے client id ایک نامکمل سیٹ اپ ہے، اور دونوں مقرر ہونے تک Google sign-ins رد کیے جاتے ہیں۔
کسی دوسرے client پر تبدیل کرنے سے Google Calendar میں ہر کوئی sign out ہو جاتا ہے: sign-in اس client کا ہوتا ہے جس نے اسے جاری کیا۔
ایک workspace کو اپنا Google client دیں
سیکشن کا عنوان “ایک workspace کو اپنا Google client دیں”ایک workspace سرور کے client کے بجائے اپنے client کے ذریعے Google Calendar جوڑ سکتا ہے۔ یہ صرف workspace admin یا owner ترتیب دے سکتا ہے۔
- اوپر کے مراحل 1 اور 2 کی طرح Web application client بنائیں
- ترتیبات → ورک اسپیس → انٹیگریشنز پر جائیں۔ Control Center Connect کارڈ پر اپنی ایپس استعمال کریں چنیں اور لاگو کریں پر کلک کریں
- Calendar کے تحت Google Calendar ایپ کارڈ ظاہر ہوتا ہے۔ کارڈ کے Callback URL کے تحت دکھایا گیا redirect URI client میں ہو بہو شامل کریں
- Client id اور Client secret چسپاں کریں
اس workspace میں جڑے calendar accounts پھر اس client سے گزرتے ہیں، چاہے سرور لوگوں کو کسی بھی طریقے سے sign in کرائے۔ یہ کبھی سرور کے client یا Connect پر fall back نہیں کرتا: جب تک دونوں فیلڈز مکمل نہ ہوں، اس workspace میں Google Calendar بند رہتا ہے، اور کارڈ بتاتا ہے کیا غائب ہے۔ secret کبھی سرور سے باہر نہیں جاتا۔
اپنی ایپس استعمال کریں ہر provider پر بیک وقت لاگو ہوتا ہے: GitHub، Linear اور GIF سرچ بھی صرف workspace کی اپنی ایپس پر چلتی ہیں۔ workspace کی sign-in ایپس بدلنے، یا workspace کے client id کو بدلنے سے، اس workspace کے ہر Google account کو دوبارہ جوڑنے کے لیے نشان زد کیا جاتا ہے۔ محفوظ شدہ فیلڈز workspace کے کسی دوسرے انتخاب پر واپس جانے پر برقرار رہتے ہیں، مگر صرف اپنی ایپس استعمال کریں کے تحت استعمال ہوتے ہیں۔ سرور کے دوسرے workspaces متاثر نہیں ہوتے۔
خرابیوں کا ازالہ
سیکشن کا عنوان “خرابیوں کا ازالہ”| علامت | ممکنہ وجہ |
|---|---|
| Google Calendar منسلک کریں کہتا ہے sign-in سیٹ نہیں | سرور کے پاس نہ اپنا Google client ہے نہ Connect۔ سرور کا مالک ترتیبات → سرور → سنگل سائن آن میں ایک چنتا ہے |
Google redirect_uri_mismatch دکھاتا ہے |
client پر رجسٹر redirect کال بیک URLs کی قدر سے ہو بہو مطابقت نہیں رکھتا، یا سرور کا عوامی URL بدل گیا |
Google سے invalid_client |
id اور secret مختلف clients کے ہیں، یا client حذف ہو گیا |
| منظوری کامیاب مگر sync خالی | آپ کا account consent screen پر test user نہیں، یا درخواست کیے گئے کسی scope کو نہیں دیا گیا |
| dialog کہتا ہے کوڈ میل نہیں کھاتا | 8 حروف بالکل ویسے ٹائپ کریں جیسے براؤزر دکھاتا ہے۔ پانچ غلط کوڈ sign-in ختم کر دیتے ہیں؛ دوبارہ شروع کریں |
| “Couldn’t update your response” یا event بنانے، منتقل کرنے یا حذف کرنے میں ناکامی | اکاؤنٹ کو calendar لکھنے کی اجازت نہیں دی گئی تھی۔ دوبارہ جوڑیں اور مانگے گئے ہر scope کو منظور کریں؛ آپ کے ساتھ صرف پڑھنے کے لیے بانٹا گیا calendar بھی لکھنے سے انکار کرتا ہے |
| سب کو دوبارہ جوڑنا پڑتا ہے | سرور یا workspace کا Google client بدل گیا، یا سرور یا workspace کا Connect انتخاب بدل گیا، یا سرور کی key بدل گئی۔ دیکھیں منقضی account کو دوبارہ جوڑنا |
متعلقہ گائیڈز
سیکشن کا عنوان “متعلقہ گائیڈز”- ایک میٹنگ ریکارڈ اور خلاصہ کریں: ایک event کو recording میں بدلیں
- Headless سرور چلائیں: جہاں credentials اور sync کا شیڈول رہتے ہیں
- Connect سرور چلائیں