اتصال به Google Calendar

اتصال Google Calendar در تسکیـ تغییر رویدادهای تقویم را به کارهای قابل پیگیری وصل می‌کند. وقتی کانال push گوگل برای فضای کاری ثبت شود، اعلان‌های تغییر رویداد دریافت می‌شوند و اگر اطلاعات رویداد شامل شناسهٔ وظیفه باشد، همان رویداد به وظیفه لینک می‌شود.

دامنهٔ نسخه فعلی: این نسخه روی دریافت امن اعلان‌های push و لینک خودکار رویدادهای غنی‌شده به وظیفه تمرکز دارد. اتصال OAuth شخصی، همگام‌سازی دوطرفه، نمایش رویدادها در Planner/Calendar views، ساخت رویداد از تسکیـ، واکشی incremental با syncToken، پیش‌نمایش لینک‌ها، AI tools و مدیریت خودکار کانال‌های Google Calendar در فازهای بعدی اضافه می‌شوند.

پیش از شروع

• فقط مالک یا مدیر فضای کاری می‌تواند اتصال Google Calendar فضای کاری را بسازد یا قطع کند.
• در Google Calendar API باید برای منبع events یک watch channel بسازید و endpoint تسکیـ را به‌عنوان address وارد کنید.
• شناسهٔ کانال در فیلد «شناسه Channel» و token کانال در فیلد «Channel Token» ذخیره می‌شود.
• اعلان رسمی Google Calendar معمولاً بدنهٔ رویداد را ارسال نمی‌کند؛ برای لینک خودکار، پردازش بعدی یا منبع غنی‌شده باید عنوان یا توضیح رویداد را به تسکیـ برساند.
• اتصال شخصی و دسترسی مستقیم به تقویم خصوصی کاربران در نسخه فعلی فعال نیست.

ساخت اتصال فضای کاری

1. در Google Calendar API یک درخواست events.watch برای تقویم موردنظر بسازید.
2. مقدار id کانال را نگه دارید؛ همین مقدار در هدر X-Goog-Channel-ID ارسال می‌شود.
3. برای کانال یک token غیرحساس بسازید؛ گوگل آن را در هدر X-Goog-Channel-Token برمی‌گرداند و تسکیـ با آن درخواست را بررسی می‌کند.
4. در مرکز اپ‌های تسکیـ، Google Calendar را باز کنید و تب «فضای کاری» را انتخاب کنید.
5. Channel ID، Channel Token، توکن دسترسی اختیاری و برچسب اتصال را وارد کنید.

امنیت Channel Token: تسکیـ مقدار X-Goog-Channel-Token را با مقدار رمزنگاری‌شدهٔ اتصال مقایسه می‌کند. این هدر در رکورد تحویل وب‌هوک ذخیره نمی‌شود و نباید شامل OAuth token یا دادهٔ حساس باشد.

لینک خودکار رویداد به وظیفه

برای لینک خودکار، شناسهٔ وظیفه را در عنوان یا توضیح رویداد بنویسید. شکل‌های زیر پشتیبانی می‌شوند:

• TASK-12 — نوشتن مستقیم شناسه.
• #TASK-12 — با پیشوند #.
• CU-TASK-12 — با پیشوند CU-.
• #9fq2b1 — شناسهٔ هش‌شدهٔ وظیفه، فقط با پیشوند # یا CU-.

برای نمونه، رویداد TASK-51 planning review به وظیفهٔ TASK-51 لینک می‌شود و در بخش لینک‌های متصل وظیفه دیده خواهد شد.

وضعیت وظیفه و دستورهای وضعیت

Google Calendar در نسخه فعلی وضعیت وظیفه را تغییر نمی‌دهد. اگر عبارت TASK-51[Done] را در عنوان یا توضیح رویداد بنویسید، رویداد به وظیفه لینک می‌شود اما وضعیت وظیفه تغییر نمی‌کند. تغییر وضعیت خودکار فعلاً برای رویدادهای GitHub و GitLab فعال است.

مدیریت و قطع اتصال

وضعیت اتصال و زمان آخرین رویداد در تب «یکپارچه‌سازی» تنظیمات فضای کاری دیده می‌شود. مالک یا مدیر می‌تواند اتصال را از تسکیـ قطع کند. برای توقف کامل ارسال اعلان‌ها، کانال watch را در Google Calendar API هم متوقف یا منقضی کنید.

اشتباه‌های رایج

• وارد کردن Calendar ID به‌جای Channel ID؛ مقدار اتصال باید همان id کانال watch باشد.
• قرار دادن OAuth token داخل Channel Token؛ گوگل هم توصیه می‌کند token کانال شامل دادهٔ حساس نباشد.
• انتظار داشتن جزئیات کامل رویداد داخل اعلان رسمی گوگل؛ اعلان push معمولاً فقط هدرهای تغییر را ارسال می‌کند.
• انتظار همگام‌سازی دوطرفه یا نمایش تقویم خصوصی کاربر؛ این قابلیت‌ها هنوز در نسخه فعلی فعال نیستند.
• انتظار تغییر وضعیت با کروشهٔ وضعیت؛ Google Calendar فقط لینک می‌کند و وضعیت را تغییر نمی‌دهد.

گام بعدی: اگر فقط یک خروجی خواندنی برای برنامهٔ تقویم می‌خواهید، راهنمای همگام‌سازی iCal را ببینید. برای اتصال گفتگوهای برنامه‌ریزی، اتصال به Slack را مرور کنید.