نود Google Drive در N8N
نود 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 استفاده شود.
خطای 401 Unauthorized
این خطا معمولاً به دلیل نامعتبر بودن Credential، منقضیشدن Token یا ناقصبودن تنظیمات OAuth رخ میدهد.
- Credential را دوباره متصل کنید.
- مطمئن شوید Google Drive API در Google Cloud فعال است.
- Redirect URL مربوط به N8N را در Google Cloud Console درست وارد کنید.
خطای 403 Forbidden
این خطا نشان میدهد حساب متصل مجوز کافی برای عملیات موردنظر ندارد.
- بررسی کنید فایل یا پوشه با حساب متصل به اشتراک گذاشته شده باشد.
- برای Shared Drive نقش کاربر را بررسی کنید.
- Scopeهای Credential را بررسی و در صورت نیاز کاملتر کنید.
- اگر عملیات Share انجام میدهید، سیاستهای Google Workspace ممکن است اشتراکگذاری بیرون از سازمان را محدود کرده باشد.
خطای 404 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 آپلود گردد، دسترسی مشاهده ایجاد شود و لینک آن برای مدیران ارسال شود.