آموزش اتصال Google Sheets به n8n + ساخت کلید OAuth2 و حل خطاها

مقدمه

آموزش اتصال google sheets به n8n

گوگل شیت (Google Sheets) محبوب‌ترین ابزار ذخیره‌سازی و مدیریت داده‌ها در پروژه‌های اتوماسیون است. با اتصال Google Sheets به n8n می‌توانید فرم‌های ورود اطلاعات بسازید، گزارش‌های کاری را خودکار به جدول منتقل کنید، لیدهای فروش را ذخیره کرده یا اطلاعات را خوانده و بررسی کنید. در این راهنما، آموزش اتصال Google Sheets به n8n را به‌صورت گام‌به‌گام و با استفاده از روش امن OAuth2 یاد می‌گیرید.

N8N برای چه کسب و کارهایی مناسب است:

اگر سازمان شما کوچک می باشد و هم اکنون بسیاری از کار های خود را با نرم افزار هایی همچون اکسل انجام می دهید، N8N برای کسب و کار شما ایده آل است و در صورتی که کسب و کاری متوسط یا بزرگ دارید می توانید بخش های بسیاری از فرایند های غیر کلیدی خود را با این ابزار هوشمند کنید.

اگر به پیاده‌سازی اختصاصی، اتصال n8n به نرم‌افزارهای سازمانی یا سفارشی‌سازی Workflowها متناسب با کسب‌وکارتان نیاز دارید، Danix با بررسی نیازهای کسب‌وکار تان، می‌تواند این فرایند را از طراحی تا استقرار برای شما انجام دهیم.

برای کسب و کارهای کوچک به این لینک مراجعه کنید و برای کسب و کارهای بزرگ و متوسط میتوانید از این لینک استفاده نمایید. همچنین اگر ترجیح می‌دهید شخصاً نصب و راه‌اندازی را انجام دهید، می‌توانید از اطلاعات موجود در مقالات، دسته N8N استفاده کنید .

پیش‌نیازها

قبل از شروع، موارد زیر را آماده کنید:

  • یک نسخه فعال از n8n (اگر هنوز آن را نصب نکرده‌اید، آموزش کامل نصب و راه‌اندازی n8n را مطالعه کنید).

  • یک حساب کاربری گوگل (Gmail یا Google Workspace).

  • یک فایل گوگل شیت آماده برای تست اتصال.

گام اول: فعال‌سازی API و ساخت کلید OAuth2 در Google Cloud

برای برقراری اتصال امن بین n8n و گوگل شیت، باید دسترسی Google Sheets API را در کنسول گوگل فعال کنید:

  1. وارد Google Cloud Console شوید.

  2. پروژه قبلی خود (که در مقاله اتصال جیمیل ساختید) را انتخاب کنید یا یک New Project جدید بسازید.

  3. از منوی سمت چپ به مسیر APIs & Services > Library بروید.

  4. عبارت Google Sheets API را سرچ کرده، روی آن کلیک کنید و دکمه Enable را بزنید. (نکته: توصیه می‌شود Google Drive API را هم فعال کنید تا n8n بتواند فایل‌های شیت شما را جستجو کند).

  5. از منوی سمت چپ به بخش Credentials بروید، روی Create Credentials کلیک کرده و OAuth client ID را انتخاب کنید.

  6. نوع برنامه (Application type) را روی Web application بگذارید.

  7. در بخش Authorized redirect URIs، آدرس Redirect URL اختصاصی n8n خود را وارد کنید (به فرمت https://your-n8n-domain.com/rest/oauth2-credential/callback).

  8. روی Create کلیک کرده و دو کد Client ID و Client Secret نمایش داده‌شده را کپی کنید.

آموزش اتصال Google Sheets به n8n
آموزش اتصال Google Sheets به n8n
آموزش اتصال Google Sheets به n8n
آموزش اتصال Google Sheets به n8n

گام دوم: ثبت Credential در محیط n8n

  1. وارد پنل n8n شوید و از منوی سمت چپ گزینه Credentials را انتخاب کنید.

  2. روی Add Credential کلیک کرده و Google Sheets OAuth2 API را سرچ و انتخاب کنید.

  3. مقادیر Client ID و Client Secret دریافتی از گوگل کلود را در کادرهای مربوطه قرار دهید.

  4. مطمئن شوید آدرس OAuth Redirect URL با آدرسی که در گوگل کلود وارد کرده‌اید مطابقت دارد.

  5. روی دکمه Sign in with Google کلیک کنید، حساب گوگل خود را انتخاب کرده و دسترسی‌های لازم را تایید (Allow) کنید.

  6. پس از بازگشت موفقیت‌آمیز به n8n، دکمه Save را بزنید.

گام سوم: تست اتصال با یک نود ساده (Quick Test)

برای تست اتصال Google Sheets به n8n:

  1. یک فایل گوگل شیت جدید در اکانت خود بسازید و در سطر اول آن چند عنوان ستون (مثلاً: Name و Email) بنویسید.

  2. وارد n8n شده و یک Workflow جدید بسازید.

  3. نود Manual Trigger را اضافه کنید.

  4. نود Google Sheets را اضافه کرده و در بخش Credential to use، اعتباری را که ساختید انتخاب کنید.

  5. بخش Operation را روی Append or Update Row یا Read Rows بگذارید.

  6. فایل گوگل شیت خود را از لیست فایل‌ها انتخاب کنید (با استفاده از لینک فایل یا ID آن).

  7. روی Execute step کلیک کنید. خوانده شدن اطلاعات جدول نشان‌دهنده اتصال موفق است.

خطاهای رایج و روش حل آن‌ها (Troubleshooting)

در فرایند اتصال ممکن است با خطاهای زیر مواجه شوید:

جمع‌بندی و مقالات مرتبط

اتصال گوگل شیت به n8n پایگاه داده‌ای ساده، رایگان و انعطاف‌پذیر در اختیار تمام سناریوهای خودکارسازی شما قرار می‌دهد.

مطالعه مقاله پایه: آموزش کامل نصب و راه‌اندازی n8n | معرفی قابلیت‌ها و ساخت اولین Workflow

سایر مقالات مرتبط: راه اندازی n8n و اتصال Credential ها

Categories: , ,

توسعه توسط تیم میهن وردپرس