اتصال به Google Drive

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

دامنهٔ نسخه فعلی: این نسخه روی دریافت امن اعلان‌های push و لینک خودکار فایل‌های غنی‌شده به وظیفه تمرکز دارد. اتصال OAuth شخصی، فایل‌پیکر، پیوست مستقیم فایل، ساخت Docs/Sheets/Slides، Connected Search، پیش‌نمایش لینک‌ها، Super Agent search، اتوماسیون‌های Drive و مدیریت خودکار کانال‌های Google Drive در فازهای بعدی اضافه می‌شوند.

پیش از شروع

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

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

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

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

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

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

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

برای نمونه، فایل TASK-61 launch brief به وظیفهٔ TASK-61 لینک می‌شود و در بخش لینک‌های متصل وظیفه دیده خواهد شد.

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

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

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

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

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

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

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