ساخت خودکار رویداد در Google Calendar با n8n

اتوماسیون ایجاد رویداد در Google Calendar

این راهنما نحوه راه‌اندازی یک گردش کار (workflow) را برای افزودن خودکار رویدادها به Google Calendar شما شرح می‌دهد. این قابلیت برای زمان‌بندی وظایف، یادآوری‌ها یا هر رویداد تکراری مستقیماً از نمونه n8n شما مفید است.

کاتالوگ n8n Axeto: https://axeto.ai/n8n

نمای کلی گردش کار

این گردش کار فرآیند افزودن یک رویداد جدید به یک Google Calendar مشخص را خودکار می‌کند. این گردش کار برای فعال‌سازی دستی طراحی شده است و به شما امکان می‌دهد در صورت نیاز، ایجاد رویداد را آغاز کنید. گردش کار از دو جزء اصلی تشکیل شده است:

1. فعال‌ساز دستی (Manual Trigger): این نود به عنوان نقطه شروع عمل می‌کند و به شما امکان می‌دهد گردش کار را به صورت دستی اجرا کنید.

2. نود Google Calendar: این نود مسئولیت ایجاد واقعی رویداد در Google Calendar شما را با استفاده از زمان‌های شروع و پایان از پیش تعریف شده بر عهده دارد.

پیاده‌سازی گام به گام

۱. نود فعال‌ساز دستی (Manual Trigger Node)

این نود اجرای گردش کار را آغاز می‌کند.

• نوع نود: n8n-nodes-base.manualTrigger
• هدف: ارائه یک نقطه شروع دستی برای گردش کار، چه در ویرایشگر n8n و چه از طریق فراخوانی API.
• پیکربندی: هیچ پارامتر خاصی برای این نود نیاز به پیکربندی ندارد؛ تنظیمات پیش‌فرض آن کافی است.
• اجرا: روی دکمه "Execute Workflow" در رابط کاربری n8n کلیک کنید یا آن را به صورت برنامه‌نویسی فعال کنید.

۲. نود Google Calendar

این نود مسئول ایجاد رویداد در Google Calendar شما است.

• نوع نود: n8n-nodes-base.googleCalendar
• هدف: افزودن یک رویداد جدید به یک Google Calendar مشخص.
• پیکربندی:

* Calendar: آدرس ایمیل Google Calendar مورد نظر خود را وارد کنید (مثلاً shaligramshraddha@gmail.com).

* Start: تاریخ و زمان شروع رویداد را تعریف کنید. این باید در فرمت ISO 8601 باشد (مثلاً 2020-06-25T07:00:00.000Z).

* End: تاریخ و زمان پایان رویداد را نیز در فرمت ISO 8601 تعریف کنید (مثلاً 2020-06-27T07:00:00.000Z).

* Additional Fields: شما می‌توانید به صورت اختیاری فیلدهایی مانند Description، Summary یا Location را برای اطلاعات دقیق‌تر رویداد پیکربندی کنید.

• اعتبارنامه‌ها (Credentials): شما باید اعتبارنامه‌های OAuth2 Google Calendar را راه‌اندازی و احراز هویت کنید. اطمینان حاصل کنید که این اعتبارنامه‌ها دارای دامنه (scope) لازم (https://www.googleapis.com/auth/calendar) برای نوشتن رویدادها هستند.

اتصال نودها

1. یک نود Manual Trigger به بوم گردش کار خود اضافه کنید.

2. یک نود Google Calendar به بوم گردش کار خود اضافه کنید.

3. خروجی نود Manual Trigger را به ورودی نود Google Calendar متصل کنید.

اجرای گردش کار

1. گردش کار خود را ذخیره کنید.

2. روی دکمه "Execute Workflow" کلیک کنید.

3. Google Calendar مشخص شده خود را برای رویداد تازه ایجاد شده بررسی کنید.

عیب‌یابی و بهترین شیوه‌ها

• احراز هویت: اطمینان حاصل کنید که اعتبارنامه‌های OAuth2 Google Calendar شما معتبر هستند و مجوزهای صحیح را دارند. اگر با خطاهای احراز هویت مواجه شدید، مجدداً احراز هویت کنید یا اعتبارنامه‌های جدیدی ایجاد کنید.
• فرمت تاریخ و زمان: همیشه از فرمت ISO 8601 برای تاریخ‌های شروع و پایان استفاده کنید. افزودن Z نشان‌دهنده زمان UTC است.
• مجوزهای تقویم: تأیید کنید که حساب Google مرتبط با اعتبارنامه‌های شما مجوز افزودن رویداد به تقویم هدف را دارد.
• داده‌های پویا: برای موارد استفاده پیشرفته‌تر، استفاده از عبارات n8n (n8n expressions) را برای تنظیم پویا جزئیات رویداد (زمان‌های شروع/پایان، عنوان، توضیحات) بر اساس داده‌های نودهای قبلی یا منابع خارجی در نظر بگیرید. به مستندات عبارات n8n مراجعه کنید.
• فعال‌سازی API گوگل: اطمینان حاصل کنید که Google Calendar API در پروژه Google Cloud شما که با اعتبارنامه‌های OAuth2 مرتبط است، فعال شده است. می‌توانید این کار را از طریق کنسول API گوگل انجام دهید.