نود Google Drive در N8N

نود Google Drive در N8N یکی از کاربردی‌ترین نودها برای اتصال ورکفلوهای اتوماسیون به فضای ذخیره‌سازی گوگل است. با این نود می‌توانید فایل‌ها را آپلود، دانلود، کپی، حذف، جابه‌جا، به‌روزرسانی و اشتراک‌گذاری کنید، پوشه بسازید، فایل‌ها را جست‌وجو کنید و حتی با Google Drive Trigger تغییرات فایل‌ها و پوشه‌ها را به‌صورت خودکار دنبال کنید.

اگر در پروژه‌های خود با گزارش‌ها، فاکتورها، فایل‌های CSV، PDF، تصاویر، بکاپ‌ها یا اسناد تیمی سروکار دارید، نود Google Drive می‌تواند نقش مرکز ذخیره‌سازی و مدیریت فایل را در ورکفلوهای شما ایفا کند.

معرفی نود در N8N

نود Google Drive یک نود Integration در N8N است که امکان ارتباط مستقیم با Google Drive API را فراهم می‌کند. این نود معمولاً به‌عنوان Action Node استفاده می‌شود، یعنی عملیاتی مانند آپلود، دانلود، حذف یا جست‌وجوی فایل را انجام می‌دهد. علاوه بر آن، نود جداگانه‌ای با عنوان Google Drive Trigger نیز وجود دارد که برای شروع خودکار ورکفلو هنگام ایجاد یا تغییر فایل‌ها در Google Drive استفاده می‌شود.

دسته‌بندی نود

Integration: اتصال N8N به سرویس خارجی Google Drive
Action: انجام عملیات روی فایل‌ها، پوشه‌ها و دسترسی‌ها
Trigger: در قالب Google Drive Trigger برای شروع ورکفلو بر اساس تغییرات Google Drive

کارکرد اصلی نود

کارکرد اصلی این نود، مدیریت فایل‌ها و پوشه‌ها در Google Drive از داخل ورکفلوهای N8N است. برای مثال می‌توانید یک فایل PDF تولیدشده توسط نودهای دیگر را در Drive آپلود کنید، لینک اشتراک‌گذاری بسازید و سپس آن را از طریق Gmail، Telegram یا Slack ارسال کنید.

اهمیت نود در ورکفلوها

Google Drive در بسیاری از سازمان‌ها و تیم‌ها محل اصلی نگهداری فایل‌هاست. اتصال آن به N8N باعث می‌شود فرآیندهای تکراری مربوط به فایل‌ها خودکار شوند؛ مانند ذخیره گزارش روزانه، آرشیو پیوست‌های ایمیل، دسته‌بندی فایل‌های ورودی، ایجاد پوشه برای مشتریان جدید یا پردازش فایل‌های CSV و Excel.

موارد استفاده

ذخیره خودکار پیوست‌های ایمیل در Google Drive

یکی از سناریوهای رایج، دریافت ایمیل از Gmail و ذخیره پیوست‌های آن در یک پوشه مشخص در Google Drive است. این کار برای تیم‌های مالی، منابع انسانی و پشتیبانی بسیار کاربردی است.

Gmail Trigger: دریافت ایمیل جدید
IF: بررسی وجود پیوست
Google Drive: آپلود فایل در پوشه مشخص
Google Sheets: ثبت نام فایل، فرستنده و تاریخ دریافت

ساخت پوشه برای هر مشتری جدید

وقتی اطلاعات مشتری جدید از فرم سایت، CRM یا Google Sheets وارد می‌شود، می‌توانید به‌صورت خودکار برای او یک پوشه اختصاصی در Google Drive ایجاد کنید.

Webhook: دریافت اطلاعات مشتری از سایت
Google Drive: ایجاد پوشه با نام مشتری
Google Sheets: ذخیره لینک پوشه در فایل مشتریان
Slack یا Telegram: اطلاع‌رسانی به تیم فروش

آپلود گزارش‌های روزانه و هفتگی

اگر ورکفلوهای شما فایل‌های گزارش تولید می‌کنند، مثل CSV، PDF یا JSON، می‌توانید آن‌ها را در Google Drive ذخیره و آرشیو کنید.

Cron: اجرای زمان‌بندی‌شده روزانه
HTTP Request: دریافت داده از API
Spreadsheet File: تبدیل داده به CSV یا XLSX
Google Drive: آپلود فایل خروجی

پردازش فایل‌های جدید در یک پوشه

با Google Drive Trigger می‌توانید هر زمان فایلی در یک پوشه ایجاد یا به‌روزرسانی شد، ورکفلو را اجرا کنید. این سناریو برای پردازش فایل‌های CSV، تصاویر، قراردادها یا فایل‌های بارگذاری‌شده توسط کاربران مناسب است.

Google Drive Trigger: تشخیص فایل جدید در پوشه
Google Drive: دانلود فایل
Code یا Spreadsheet File: پردازش محتوای فایل
Database یا Google Sheets: ذخیره نتیجه پردازش

اشتراک‌گذاری خودکار فایل‌ها

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

Google Drive: آپلود فایل
Google Drive: ایجاد Permission یا Share
Email یا Slack: ارسال لینک فایل به افراد مربوطه

پارامترها و تنظیمات

پارامترهای نود Google Drive بسته به Resource و Operation انتخاب‌شده تغییر می‌کنند. در جدول‌های زیر مهم‌ترین تنظیمات این نود توضیح داده شده‌اند. نام دقیق برخی گزینه‌ها ممکن است بسته به نسخه N8N کمی متفاوت باشد، اما منطق کلی استفاده از آن‌ها ثابت است.

تنظیمات اتصال و احراز هویت

نام پارامتر	نوع داده	توضیح کاربرد	مثال عملی
Credential	Credential	اطلاعات اتصال به حساب Google Drive. معمولاً از OAuth2 استفاده می‌شود.	اتصال حساب Google Workspace شرکت به N8N
Authentication	انتخابی	روش احراز هویت. در بیشتر موارد Google OAuth2 استفاده می‌شود. در برخی تنظیمات امکان استفاده از Service Account نیز وجود دارد.	OAuth2 برای دسترسی به Drive شخصی یا سازمانی
Scopes	متنی / مجوز	سطح دسترسی موردنیاز به Google Drive. این مورد معمولاً هنگام ساخت Credential در Google Cloud تنظیم می‌شود.	دسترسی خواندن و نوشتن فایل‌ها

پارامتر Resource

نام پارامتر	نوع داده	توضیح کاربرد	مثال عملی
Resource	انتخابی	مشخص می‌کند عملیات روی چه نوع منبعی انجام شود؛ فایل، پوشه، درایو مشترک یا دسترسی‌ها.	File برای آپلود یا دانلود فایل
File	Resource	برای عملیات مربوط به فایل‌ها مانند Upload، Download، Copy، Delete، Move و Update استفاده می‌شود.	دانلود فایل CSV از Drive
Folder	Resource	برای ساخت، جست‌وجو یا مدیریت پوشه‌ها استفاده می‌شود.	ساخت پوشه اختصاصی برای مشتری
Drive	Resource	برای کار با Shared Drive یا Team Drive در نسخه‌هایی که این گزینه را پشتیبانی می‌کنند.	انتخاب Shared Drive تیم مالی
Permission	Resource	برای مدیریت دسترسی‌ها و اشتراک‌گذاری فایل یا پوشه.	دادن دسترسی View به ایمیل مشتری

عملیات‌های رایج برای File

Operation	توضیح	کاربرد عملی
Upload	آپلود فایل جدید در Google Drive از داده باینری یا متن.	آپلود خروجی PDF تولیدشده در ورکفلو
Download	دانلود فایل از Google Drive و تبدیل آن به Binary Data در N8N.	دانلود فایل CSV برای پردازش
Delete	حذف فایل از Google Drive.	پاک‌سازی فایل‌های موقت قدیمی
Copy	کپی کردن یک فایل موجود.	ساخت کپی از قالب قرارداد برای مشتری جدید
Move	انتقال فایل به پوشه‌ای دیگر.	انتقال فایل پردازش‌شده به پوشه Archive
Update	به‌روزرسانی مشخصات یا محتوای فایل.	تغییر نام فایل یا جایگزینی محتوای آن
Share	ایجاد لینک اشتراک‌گذاری یا تنظیم دسترسی.	ارسال لینک مشاهده فایل برای کارفرما
Search	جست‌وجوی فایل‌ها بر اساس نام، نوع، پوشه یا Query.	پیدا کردن آخرین گزارش فروش

پارامترهای عمومی فایل

نام پارامتر	نوع داده	توضیح کاربرد	مثال عملی
File ID	String	شناسه یکتای فایل در Google Drive. برای دانلود، حذف، کپی، جابه‌جایی و به‌روزرسانی استفاده می‌شود.	1A2B3CxyzFileId
File Name	String	نام فایل هنگام آپلود، کپی یا تغییر نام.	invoice-{{$json.orderId}}.pdf
Parent Folder	String / انتخابی	پوشه مقصد برای آپلود، کپی یا انتقال فایل.	شناسه پوشه فاکتورهای سال ۱۴۰۳
Binary Property	String	نام فیلدی که داده باینری فایل در آن قرار دارد. معمولاً data است.	data
Mime Type	String	نوع فایل برای Google Drive. گاهی به‌صورت خودکار تشخیص داده می‌شود، اما در بعضی سناریوها بهتر است دستی تنظیم شود.	application/pdf یا text/csv
Fields	String	مشخص می‌کند چه فیلدهایی از پاسخ Google Drive API برگردانده شود. برای کاهش حجم خروجی مفید است.	id,name,webViewLink,mimeType
Options	Object	تنظیمات تکمیلی مانند پشتیبانی از Shared Drive، تبدیل فایل یا محدودکردن خروجی.	فعال‌کردن Supports All Drives

پارامترهای Upload

نام پارامتر	نوع داده	توضیح کاربرد	مثال عملی
Input Data Field Name	String	نام فیلد باینری ورودی که فایل در آن قرار دارد.	data
Name	String	نام فایل نهایی در Google Drive.	daily-report-{{$now.format(‘yyyy-MM-dd’)}}.csv
Folder ID	String	شناسه پوشه‌ای که فایل باید در آن آپلود شود.	1XFolderIdReports
File Content	String	در بعضی حالت‌ها می‌توان فایل متنی را مستقیماً از مقدار متنی ساخت.	محتوای یک فایل .txt شامل لاگ روزانه
Convert to Google Docs Format	Boolean	در برخی نسخه‌ها امکان تبدیل فایل‌های Office به فرمت Google Docs/Sheets وجود دارد.	تبدیل XLSX به Google Sheets

پارامترهای Download

نام پارامتر	نوع داده	توضیح کاربرد	مثال عملی
File ID	String	شناسه فایلی که باید دانلود شود.	شناسه فایل CSV ورودی
Put Output File in Field	String	نام فیلد باینری خروجی که فایل دانلودشده در آن ذخیره می‌شود.	data
Google File Conversion	انتخابی	اگر فایل از نوع Google Docs، Google Sheets یا Google Slides باشد، باید فرمت خروجی برای Export مشخص شود.	Export Google Sheets به xlsx یا csv

پارامترهای Search

نام پارامتر	نوع داده	توضیح کاربرد	مثال عملی
Search Method	انتخابی	روش جست‌وجو؛ معمولاً بر اساس نام فایل، Query یا پوشه.	جست‌وجو با نام report
Query	String	عبارت جست‌وجوی Google Drive API برای فیلترکردن فایل‌ها.	name contains ‘invoice’ and trashed = false
Return All	Boolean	اگر فعال باشد، همه نتایج منطبق برمی‌گردد.	دریافت همه فایل‌های PDF یک پوشه
Limit	Number	حداکثر تعداد نتایج زمانی که Return All غیرفعال است.	10
Folder ID	String	محدودکردن جست‌وجو به یک پوشه خاص.	جست‌وجو فقط در پوشه قراردادها

پارامترهای Folder

نام پارامتر	نوع داده	توضیح کاربرد	مثال عملی
Folder Name	String	نام پوشه‌ای که باید ساخته یا جست‌وجو شود.	Customer – {{$json.customerName}}
Parent Folder	String	پوشه والد که پوشه جدید داخل آن ساخته می‌شود.	پوشه اصلی مشتریان
Folder ID	String	شناسه پوشه برای عملیات‌هایی مانند حذف، انتقال یا جست‌وجوی داخلی.	1FolderIdCustomers

پارامترهای Share و Permission

نام پارامتر	نوع داده	توضیح کاربرد	مثال عملی
File ID / Folder ID	String	شناسه فایل یا پوشه‌ای که قرار است به اشتراک گذاشته شود.	شناسه فایل قرارداد
Type	انتخابی	نوع مخاطب دسترسی؛ مانند user، group، domain یا anyone.	user برای یک ایمیل خاص
Role	انتخابی	سطح دسترسی؛ مانند reader، writer یا commenter.	reader برای مشاهده فقط
Email Address	String	ایمیل کاربر یا گروهی که دسترسی دریافت می‌کند.	client@example.com
Domain	String	دامنه سازمانی در صورت اشتراک‌گذاری برای کل دامنه.	example.com
Allow File Discovery	Boolean	مشخص می‌کند فایل برای افراد دارای لینک قابل کشف باشد یا فقط با لینک مستقیم قابل دسترسی باشد.	false برای لینک خصوصی‌تر
Send Notification Email	Boolean	در صورت پشتیبانی، ایمیل اطلاع‌رسانی دسترسی برای کاربر ارسال می‌شود.	true برای اطلاع به مشتری

پارامترهای Shared Drive

نام پارامتر	نوع داده	توضیح کاربرد	مثال عملی
Drive ID	String	شناسه Shared Drive یا Team Drive.	شناسه درایو مشترک تیم مالی
Supports All Drives	Boolean	برای دسترسی به فایل‌های موجود در My Drive و Shared Drive باید فعال باشد.	true هنگام کار با Shared Drive
Include Items from All Drives	Boolean	در جست‌وجو، فایل‌های Shared Drive را هم در نتایج لحاظ می‌کند.	true برای جست‌وجو در همه درایوها

پارامترهای Google Drive Trigger

نام پارامتر	نوع داده	توضیح کاربرد	مثال عملی
Trigger On	انتخابی	نوع رویدادی که باعث اجرای ورکفلو می‌شود؛ مانند ایجاد فایل، تغییر فایل یا تغییر در پوشه.	وقتی فایل جدید در پوشه آپلود شد
Folder	String / انتخابی	پوشه‌ای که باید مانیتور شود.	پوشه Uploads
Poll Times	زمان‌بندی	مشخص می‌کند N8N هر چند وقت یک‌بار Google Drive را برای تغییرات بررسی کند.	هر ۵ دقیقه
Watch For	انتخابی	نوع آیتم موردنظر؛ فایل، پوشه یا هر دو.	File
Options	Object	تنظیمات تکمیلی مانند بررسی پوشه‌های Shared Drive یا فیلترهای خاص.	فعال‌کردن Include Items from All Drives

نکات مهم هنگام پیکربندی

برای استفاده از Google Drive باید ابتدا Credential معتبر بسازید و مجوزهای لازم را در Google Cloud Console فعال کنید.
برای کار با فایل‌های موجود در Shared Drive، معمولاً باید گزینه‌های Supports All Drives و Include Items from All Drives را فعال کنید.
شناسه فایل یا پوشه با نام آن متفاوت است. File ID معمولاً در URL فایل قابل مشاهده است.
هنگام آپلود فایل از نودهای دیگر، حتماً نام فیلد Binary را درست وارد کنید. رایج‌ترین مقدار data است.
برای فایل‌های Google Docs، Google Sheets و Google Slides در عملیات Download باید فرمت Export مشخص شود، چون این فایل‌ها محتوای باینری مستقیم مانند PDF یا CSV ندارند.
اگر از Query استفاده می‌کنید، عبارت باید با ساختار Google Drive Search Query سازگار باشد.

ورودی‌ها و خروجی‌ها

ورودی‌های نود

ورودی نود Google Drive بسته به عملیات انتخاب‌شده می‌تواند JSON، Binary Data یا هر دو باشد. برای مثال در عملیات Upload معمولاً فایل به‌صورت Binary از نود قبلی وارد می‌شود. در عملیات Search یا Delete ممکن است فقط یک File ID به‌صورت JSON کافی باشد.

نمونه ورودی JSON برای آپلود فایل

{  "customerName": "Ali Ahmadi",  "orderId": "ORD-1001",  "fileName": "invoice-ORD-1001.pdf",  "folderId": "1XFolderIdInvoices"}

در کنار این JSON، باید در بخش Binary نیز فایلی با نام فیلد مشخص، مثلاً data، وجود داشته باشد.

نمونه ساختار Binary ورودی

{  "binary": {    "data": {      "fileName": "invoice-ORD-1001.pdf",      "mimeType": "application/pdf",      "fileExtension": "pdf"    }  }}

خروجی‌های نود

خروجی نود Google Drive معمولاً شامل اطلاعات فایل یا پوشه است. این اطلاعات می‌تواند شامل ID، نام، MIME Type، لینک مشاهده، لینک دانلود، تاریخ ایجاد و تاریخ آخرین تغییر باشد. در عملیات Download، خروجی علاوه بر JSON شامل Binary Data فایل دانلودشده نیز خواهد بود.

نمونه خروجی عملیات Upload

{  "id": "1A2B3CxyzFileId",  "name": "invoice-ORD-1001.pdf",  "mimeType": "application/pdf",  "webViewLink": "https://drive.google.com/file/d/1A2B3CxyzFileId/view",  "webContentLink": "https://drive.google.com/uc?id=1A2B3CxyzFileId&export=download"}

نمونه خروجی عملیات Search

[  {    "id": "1FileId001",    "name": "invoice-1001.pdf",    "mimeType": "application/pdf",    "createdTime": "2026-01-10T08:30:00.000Z",    "modifiedTime": "2026-01-10T09:00:00.000Z"  },  {    "id": "1FileId002",    "name": "invoice-1002.pdf",    "mimeType": "application/pdf",    "createdTime": "2026-01-11T08:30:00.000Z",    "modifiedTime": "2026-01-11T09:00:00.000Z"  }]

نمونه خروجی عملیات Download

{  "json": {    "id": "1FileId001",    "name": "report.csv",    "mimeType": "text/csv"  },  "binary": {    "data": {      "fileName": "report.csv",      "mimeType": "text/csv",      "fileExtension": "csv"    }  }}

جدول خلاصه ورودی و خروجی

عملیات	نوع ورودی	نوع خروجی	توضیح
Upload	JSON + Binary	JSON	فایل را آپلود می‌کند و اطلاعات فایل ساخته‌شده را برمی‌گرداند.
Download	JSON	JSON + Binary	با File ID فایل را دانلود و در Binary ذخیره می‌کند.
Search	JSON	JSON	لیست فایل‌ها یا پوشه‌های منطبق را برمی‌گرداند.
Delete	JSON	JSON	فایل یا پوشه را حذف می‌کند و معمولاً وضعیت عملیات را برمی‌گرداند.
Share	JSON	JSON	اطلاعات Permission ساخته‌شده یا لینک اشتراک‌گذاری را برمی‌گرداند.

نکات پیشرفته و ترفندها

استفاده از Expression برای نام‌گذاری فایل‌ها

یکی از بهترین روش‌ها برای مدیریت فایل‌ها، نام‌گذاری پویا با Expression است. برای مثال می‌توانید نام فایل را بر اساس تاریخ، شناسه سفارش یا نام مشتری بسازید.

invoice-{{$json.orderId}}-{{$now.format('yyyy-MM-dd')}}.pdf

این روش باعث می‌شود فایل‌ها قابل جست‌وجو و مرتب‌تر باشند.

جلوگیری از آپلود فایل تکراری

قبل از آپلود فایل، یک عملیات Search انجام دهید و بررسی کنید آیا فایلی با همان نام در پوشه مقصد وجود دارد یا نه. سپس با نود IF تصمیم بگیرید فایل جدید آپلود شود یا فایل قبلی به‌روزرسانی گردد.

Google Drive Search: جست‌وجوی فایل با نام مشخص
IF: بررسی تعداد نتایج
Google Drive Upload: اگر فایل وجود نداشت
Google Drive Update: اگر فایل وجود داشت

پردازش فایل‌های CSV بعد از دانلود

اگر فایلی از Google Drive دانلود می‌کنید و فرمت آن CSV یا Excel است، می‌توانید بعد از نود Google Drive از نود Spreadsheet File استفاده کنید تا داده باینری به JSON تبدیل شود.

Google Drive: Download
Spreadsheet File: Read from file
Item Lists یا Code: پاک‌سازی و تبدیل داده‌ها
Database: ذخیره داده نهایی

استفاده از Queryهای دقیق‌تر

در جست‌وجوی فایل‌ها، Queryهای دقیق باعث کاهش تعداد نتایج و افزایش سرعت ورکفلو می‌شوند.

name contains 'invoice' and mimeType = 'application/pdf' and trashed = false

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

'1FolderIdInvoices' in parents and name contains 'invoice' and trashed = false

کاهش حجم خروجی با Fields

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

id,name,mimeType,webViewLink

کار با Shared Drive

در سازمان‌هایی که از Google Workspace استفاده می‌کنند، بسیاری از فایل‌ها در Shared Drive قرار دارند. هنگام جست‌وجو یا دانلود از Shared Drive، فعال‌بودن گزینه‌های مربوط به All Drives ضروری است.

Supports All Drives را فعال کنید.
Include Items from All Drives را در جست‌وجو فعال کنید.
در صورت وجود گزینه Drive ID، شناسه Shared Drive را مشخص کنید.

ترکیب با نود Code برای ساخت مسیرهای هوشمند

Google Drive به‌صورت واقعی ساختار مسیر شبیه فایل‌سیستم محلی ندارد و بیشتر بر اساس ID پوشه‌ها کار می‌کند. با نود Code می‌توانید منطقی بسازید که ابتدا پوشه سال، سپس ماه و سپس مشتری را پیدا یا ایجاد کند.

اگر پوشه سال وجود ندارد، ساخته شود.
داخل پوشه سال، پوشه ماه ساخته شود.
داخل پوشه ماه، پوشه مشتری ساخته شود.
فایل نهایی در آخرین پوشه آپلود شود.

ساخت لینک مستقیم مشاهده فایل

بعد از آپلود فایل، معمولاً webViewLink در خروجی وجود دارد. این لینک برای ارسال به کاربر مناسب است. اگر لینک موجود نبود، می‌توان با File ID لینک مشاهده ساخت:

https://drive.google.com/file/d/{{$json.id}}/view

محدودیت‌ها و خطاها

محدودیت‌های مهم

Google Drive API دارای محدودیت نرخ درخواست است. اجرای تعداد زیادی عملیات در مدت کوتاه ممکن است باعث خطای Rate Limit شود.
فایل‌های Google Docs، Sheets و Slides به‌صورت فایل باینری معمولی دانلود نمی‌شوند و باید Export شوند.
حذف فایل‌ها ممکن است به معنی انتقال به Trash باشد، نه حذف دائمی؛ این رفتار به عملیات و تنظیمات API بستگی دارد.
برای دسترسی به فایل‌های دیگران، Credential باید مجوز کافی داشته باشد.
Service Account به‌صورت پیش‌فرض به فایل‌های Drive شخصی کاربران دسترسی ندارد، مگر فایل یا پوشه با آن به اشتراک گذاشته شده باشد یا تنظیمات Domain-Wide Delegation انجام شده باشد.
در Shared Drive، نقش کاربر و سیاست‌های سازمانی می‌تواند مانع ایجاد، حذف یا اشتراک‌گذاری فایل شود.
نام فایل در Google Drive الزاماً یکتا نیست؛ چند فایل می‌توانند نام یکسان داشته باشند. برای عملیات دقیق بهتر است از File ID استفاده شود.

خطای ۴۰۱ Unauthorized

این خطا معمولاً به دلیل نامعتبر بودن Credential، منقضی‌شدن Token یا ناقص‌بودن تنظیمات OAuth رخ می‌دهد.

Credential را دوباره متصل کنید.
مطمئن شوید Google Drive API در Google Cloud فعال است.
Redirect URL مربوط به N8N را در Google Cloud Console درست وارد کنید.

خطای ۴۰۳ Forbidden

این خطا نشان می‌دهد حساب متصل مجوز کافی برای عملیات موردنظر ندارد.

بررسی کنید فایل یا پوشه با حساب متصل به اشتراک گذاشته شده باشد.
برای Shared Drive نقش کاربر را بررسی کنید.
Scopeهای Credential را بررسی و در صورت نیاز کامل‌تر کنید.
اگر عملیات Share انجام می‌دهید، سیاست‌های Google Workspace ممکن است اشتراک‌گذاری بیرون از سازمان را محدود کرده باشد.

خطای ۴۰۴ File Not Found

این خطا زمانی رخ می‌دهد که File ID یا Folder ID اشتباه باشد یا حساب متصل به آن فایل دسترسی نداشته باشد.

ID فایل را از URL اصلی Google Drive دوباره کپی کنید.
دسترسی حساب متصل را بررسی کنید.
اگر فایل در Shared Drive است، گزینه Supports All Drives را فعال کنید.

خطای Rate Limit یا Quota Exceeded

در اجرای حجم زیاد عملیات، Google ممکن است درخواست‌ها را محدود کند.

از نود Split In Batches برای پردازش مرحله‌ای استفاده کنید.
بین درخواست‌ها با نود Wait تأخیر قرار دهید.
فقط فیلدهای لازم را با Fields دریافت کنید.
از جست‌وجوهای کلی و بدون فیلتر خودداری کنید.

خطای Binary Property Not Found

این خطا در عملیات Upload زمانی رخ می‌دهد که نود انتظار دارد فایل در یک فیلد باینری مشخص باشد، اما چنین فیلدی در ورودی وجود ندارد.

نام Binary Property را بررسی کنید.
خروجی نود قبلی را در بخش Binary ببینید.
اگر نام فیلد data نیست، مقدار درست را در Google Drive وارد کنید.

خطای Invalid Query

این خطا هنگام استفاده از Query جست‌وجوی نامعتبر رخ می‌دهد.

از سینتکس درست Google Drive Query استفاده کنید.
رشته‌های متنی را داخل کوتیشن قرار دهید.
برای حذف فایل‌های Trash از نتیجه، شرط trashed = false را اضافه کنید.

ایده ها

سیستم آرشیو خودکار فاکتورها: دریافت فاکتور از ایمیل، استخراج اطلاعات، ذخیره PDF در Google Drive و ثبت لینک در Google Sheets.
پوشه‌سازی هوشمند برای مشتریان: با ثبت مشتری جدید در CRM، پوشه اختصاصی در Drive ساخته شود و لینک آن به پروفایل مشتری اضافه گردد.
پردازش فایل‌های آپلودشده توسط کاربران: هر فایل جدید در یک پوشه مشخص دانلود، بررسی، تبدیل و نتیجه آن در دیتابیس ذخیره شود.
سیستم بکاپ‌گیری سبک: خروجی روزانه دیتابیس یا API به‌صورت CSV یا JSON تولید و در پوشه‌های تاریخ‌دار Google Drive ذخیره شود.
ساخت و ارسال خودکار گزارش مدیریتی: گزارش PDF تولید شود، در Drive آپلود گردد، دسترسی مشاهده ایجاد شود و لینک آن برای مدیران ارسال شود.