اتصال n8n به Google Sheets
بازارچه ابریخواندن 6 دقیقه
با اتصال n8n به Google Sheets از طریق Google OAuth2، جریاندادهها میتوانند بهصورت خودکار از شیتهای گوگل بخوانند یا در آنها بنویسند. این راهنما ساخت پروژه در Google Cloud، پیکربندی OAuth و اتصال آن به n8n را پوشش میدهد.
پیشنیازها
- یک سرویس فعال n8n و دسترسی ساخت Credential
- یک حساب Google با دسترسی ساخت پروژه و OAuth Client در Google Cloud
- یک فایل Google Sheets برای آزمایش خواندن یا نوشتن داده
- یک دامنه HTTPS پایدار برای n8n؛ استفاده از دامنه اختصاصی غیر
.irتوصیه میشود
این راهنما یکی از روشهای ممکن برای اتصال n8n به Google Sheets (از طریق OAuth2) را شرح میدهد؛ روشهای دیگری مثل اتصال با Service Account هم برای همین هدف وجود دارند که در این سند پوشش داده نمیشوند.
دامنه پیشفرضی که بازارچه همروش برای سرویس n8n میسازد، زیر دامنهای از .ir است. با توجه به محدودیتهای مرتبط با تحریم، دسترسی گوگل به دامنههای .ir میتواند ناپایدار یا محدود باشد؛ برای اتصالی پایدارتر، استفاده از یک دامنه اختصاصی بهجای دامنه پیشفرض بازارچه توصیه میشود.
گام اول: ساخت پروژه و فعالسازی APIها در Google Cloud
- در Google Cloud Console، از منوی پروژه در گوشه بالا و سمت چپ صفحه، گزینه New Project انتخاب میشود.
- نامی (برای مثال
n8n-integrations) برای پروژه وارد میشود و روی Create کلیک میشود. - از مسیر APIs & Services > Library، عبارت Google Sheets API جستوجو میشود و روی Enable کلیک میشود.
- به همین ترتیب، Google Drive API هم جستوجو و فعال (Enable) میشود؛ این API برای مرور و انتخاب فایلها از داخل n8n لازم است.
گام دوم: پیکربندی Google Auth Platform (OAuth Consent Screen)
طبق مستند رسمی گوگل، پیش از صدور OAuth Client، صفحه رضایت (Consent Screen) باید پیکربندی شود. این بخش در کنسول گوگل با عنوان Google Auth Platform نمایش داده میشود و به چند تب مجزا (از جمله Overview، Branding، Audience و Clients) تقسیم شده است:
- در صورت نمایش پیام «Google auth platform not configured yet»، روی دکمه Get started کلیک میشود.
- در بخش App information، مقدار App name (برای مثال
n8n) و آدرس ایمیل برای فیلدهای User support email و Developer contact information وارد میشود و روی Save and Continue کلیک میشود. - در بخش Audience، گزینه External انتخاب میشود (مگر اینکه دسترسی باید فقط به اعضای یک حساب Workspace محدود بماند) و روی Create کلیک میشود.
طبق مستند رسمی گوگل درباره Test users، تا زمانی که اپلیکیشن در وضعیت Testing است، فقط کاربرانی که در فهرست Test users اضافه شده باشند اجازه اتصال دارند. این فهرست از تب Audience در نوار کناری Google Auth Platform و با دکمه + ADD USERS در دسترس است؛ در غیر این صورت، اتصال با خطای «Access blocked» مواجه میشود.
گام سوم: ساخت OAuth Client Credentials
- از مسیر APIs & Services > Credentials، روی Create Credentials > OAuth client ID کلیک میشود.
- مقدار Application type روی Web application تنظیم میشود و نامی (برای مثال
n8n OAuth Client) برای آن وارد میشود. - در n8n، یک credential جدید از نوع Google Sheets OAuth2 API ساخته میشود؛ مقدار OAuth Redirect URL نمایشدادهشده در همین صفحه کپی میشود. نمونها ی از این آدرس:
https://your-n8n-url.com/rest/oauth2-credential/callback
- همین آدرس، در Google Cloud و زیر بخش Authorized redirect URIs، با دکمه + ADD URI اضافه میشود و روی Create کلیک میشود.
- مقدار Client ID و Client Secret نمایشدادهشده کپی میشوند.
گام چهارم: تکمیل اتصال در n8n
- مقدار Client ID و Client Secret در پنجره credential مربوطه در n8n وارد میشود.
- روی دکمه Sign in with Google (یا Connect OAuth Account) کلیک میشود.
- در پنجره بازشده گوگل، حساب موردنظر انتخاب میشود.
- دسترسی به Sheets و Drive تأیید میشود و روی Continue کلیک میشود.
پیام «Google hasn't verified this app» به این دلیل نمایش داده میشود که اپلیکیشن ساختهشده هنوز فرایند Verification رسمی گوگل را طی نکرده است. عبور از این هشدار فقط برای آزمایش اپلیکیشنی انجام میشود که پروژه و OAuth Client آن تحت کنترل خودتان است. برای استفاده سازمانی یا ارائه به کاربران دیگر وضعیت انتشار، دامنههای مجاز و الزامات Verification گوگل باید بررسی و تکمیل شوند.
گام پنجم: انتقال به حالت دائمی (Publish App)
اتصالی که در گام قبل برقرار شد، هنوز موقتی است: طبق مستند رسمی گوگل، تا وقتی پروژه در وضعیت Testing باشد، نشست هر Test user فقط هفت روز پس از تأیید دسترسی معتبر میماند و بعد از آن باید دوباره Sign in with Google انجام شود. برای اتصال دائمی و بدون نیاز به تمدید دورهای:
- از تب Audience در نوار کناری Google Auth Platform، روی دکمه Publish App کلیک میشود.
- پروژه از وضعیت Testing به In production منتقل میشود.
طبق همان مستند رسمی گوگل، محدودیت هفتروزه فقط مخصوص وضعیت Testing است و بهمحض انتقال به In production، دیگر اعمال نمیشود؛ این کار نیازی به طی کامل فرایند Verification گوگل ندارد. پیام «Google hasn't verified this app» (که در گام قبل با مسیر Advanced > Go to ... دور زده شد) کماکان نمایش داده میشود، اما دیگر مانعی برای اتصال ایجاد نمیکند و توکن منقضی نخواهد شد؛ طی کردن کامل Verification فقط زمانی لازم است که بخواهید این پیام هشدار ب رای هیچکدام از کاربران این اپ نمایش داده نشود.
طبق مستند رسمی گوگل، تا زمانی که اپ بهطور کامل Verify نشده، حداکثر ۱۰۰ کاربر مجاز به اتصال به آن هستند؛ برای استفاده شخصی یا یک تیم داخلی این محدودیت معمولاً مشکلی ایجاد نمیکند.
عیبیابی
| خطا | علت | راهحل |
|---|---|---|
| «Access blocked: [domain] has not completed the Google verification process» | ایمیل موردنظر در فهرست Test users اضافه نشده است | از تب Audience در Google Auth Platform، در بخش Test users، ایمیل موردنظر اضافه شود |
| «Redirect URI Mismatch» | آدرس ثبتشده در Authorized redirect URIs با آدرس واقعی n8n یکسان نیست | یکسان بودن دقیق دو آدرس (پروتکل http/https و وجود یا عدم وجود / انتهایی) بررسی شود؛ با تغییر دامنه n8n، این آدرس هم باید بهروزرسانی شود |
| «403: Forbidden» یا «API not enabled» | Google Sheets API یا Google Drive API برای این پروژه فعال نشدهاند | از مسیر APIs & Services > Library، فعال بودن هر دو API بررسی شود |
| نمایش برچسب «Unsafe» روی اپ | اپ هنوز فرایند Verification گوگل را طی نکرده است | چون مالک همان توسعهدهنده است، ادامه از مسیر Advanced > Go to [App Name] (unsafe) مشکلی ندارد |
| قطعشدن اتصال یا منقضیشدن Token پس از چند روز | پروژه هنوز در وضعیت Testing است | طبق گام پنجم همین راهنما، اپ با دکمه Publish App به وضعیت In production منتقل شود |
راهنماییهای مرتبط
این راهنمایی کاربردی بود؟
با ثبت بازخوردتان در بهبود کیفیت مستندات مشارکت داشته باشید.