نود Google Slides در N8N

نود Google Slides در N8N

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

معرفی نود در N8N

Google Slides یکی از نودهای کاربردی N8N برای اتصال به سرویس Google Slides است. این نود از طریق حساب گوگل و API رسمی گوگل کار می‌کند و امکان انجام عملیات مختلف روی فایل‌های ارائه را در ورکفلوهای اتوماسیون فراهم می‌کند.

  • نام نود: Google Slides
  • دسته‌بندی: Integration / Action
  • نوع عملکرد: اجرای عملیات روی ارائه‌ها و اسلایدهای Google Slides
  • نیاز به احراز هویت: بله، از طریق Google OAuth2
  • کاربرد اصلی: ساخت، دریافت، ویرایش و خودکارسازی ارائه‌های Google Slides در ورکفلوها

این نود معمولاً زمانی استفاده می‌شود که داده‌ها از منبعی مثل Google Sheets، فرم‌ها، CRM، پایگاه داده، API یا ابزارهای هوش مصنوعی دریافت می‌شوند و باید به‌صورت خودکار داخل یک فایل ارائه قرار بگیرند.

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

نود Google Slides برای پروژه‌هایی مناسب است که در آن‌ها نیاز به تولید یا مدیریت خودکار فایل‌های ارائه وجود دارد. در ادامه چند سناریوی واقعی و کاربردی آورده شده است.

ساخت گزارش فروش ماهانه

فرض کنید داده‌های فروش هر ماه در Google Sheets ذخیره می‌شود. با ترکیب نودهای Google Sheets، Function و Google Slides می‌توان یک فایل ارائه ساخت که شامل آمار فروش، نمودارها، جمع‌بندی و تحلیل ماهانه باشد.

  • Google Sheets برای خواندن داده‌های فروش
  • Function یا Code برای محاسبه جمع کل، میانگین و نرخ رشد
  • Google Slides برای ساخت یا به‌روزرسانی ارائه گزارش
  • Gmail برای ارسال فایل یا لینک ارائه به مدیران

تولید ارائه از قالب آماده

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

  • دریافت اطلاعات مشتری از CRM
  • کپی‌کردن فایل قالب با Google Drive
  • جایگزینی نام مشتری، تاریخ، قیمت و توضیحات در Google Slides
  • ارسال لینک فایل نهایی به تیم فروش

ساخت خودکار اسلایدهای آموزشی

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

اتصال به فرم‌ها و ساخت ارائه لحظه‌ای

با ترکیب Webhook یا Google Forms با Google Slides، می‌توان بعد از ثبت اطلاعات توسط کاربر، یک فایل ارائه شخصی‌سازی‌شده تولید کرد. برای مثال کاربر فرم درخواست پروپوزال را پر می‌کند و N8N به‌صورت خودکار یک فایل Google Slides اختصاصی برای او می‌سازد.

ساخت داشبورد ارائه‌ای برای جلسات

در برخی تیم‌ها، خروجی نهایی برای جلسه باید به شکل اسلاید باشد، نه داشبورد آنلاین. می‌توان اطلاعات را از ابزارهایی مثل Notion، Airtable، HubSpot، PostgreSQL یا APIهای داخلی دریافت کرد و نتیجه را در قالب Google Slides آماده جلسه کرد.

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

پارامترهای نود Google Slides بسته به نسخه N8N و عملیات انتخاب‌شده ممکن است کمی متفاوت باشند، اما ساختار کلی آن شامل Credential، Resource، Operation و فیلدهای مربوط به شناسه ارائه، شناسه اسلاید، متن‌ها، درخواست‌های به‌روزرسانی و گزینه‌های خروجی است.

Credentials

  • نام پارامتر: Credential
  • نوع داده: Google OAuth2 Credential
  • توضیح کاربرد: برای اتصال امن N8N به حساب گوگل و دسترسی به Google Slides استفاده می‌شود.
  • مثال عملی: اتصال با حسابی که به فایل‌های Google Slides شرکت دسترسی دارد.
  • نکته مهم: حساب گوگل باید مجوز دسترسی به فایل موردنظر را داشته باشد. اگر فایل در Google Drive شخص دیگری است، باید با حساب متصل‌شده به N8N به اشتراک گذاشته شده باشد.

Resource

  • نام پارامتر: Resource
  • نوع داده: گزینه انتخابی
  • توضیح کاربرد: مشخص می‌کند عملیات روی چه بخشی انجام شود؛ معمولاً Presentation، Page یا Page Element.
  • مثال عملی: برای دریافت اطلاعات کلی فایل، Resource را روی Presentation قرار دهید. برای دریافت تصویر بندانگشتی یک اسلاید، Resource را روی Page قرار دهید.

Operation

  • نام پارامتر: Operation
  • نوع داده: گزینه انتخابی
  • توضیح کاربرد: مشخص می‌کند چه عملیاتی انجام شود؛ مثل Create، Get، Get Many، Update یا Get Thumbnail.
  • مثال عملی: برای ساخت فایل ارائه جدید، Operation را روی Create قرار دهید.

Presentation ID

  • نام پارامتر: Presentation ID
  • نوع داده: String
  • توضیح کاربرد: شناسه فایل Google Slides است که در URL فایل وجود دارد.
  • مثال عملی: اگر آدرس فایل به شکل https://docs.google.com/presentation/d/1AbCDeFG12345/edit باشد، مقدار Presentation ID برابر 1AbCDeFG12345 است.
  • نکته مهم: واردکردن کل URL به‌جای ID ممکن است باعث خطا شود؛ مگر اینکه نود در نسخه مورد استفاده از URL کامل پشتیبانی کند.

Title

  • نام پارامتر: Title
  • نوع داده: String
  • توضیح کاربرد: عنوان ارائه جدید هنگام ساخت فایل Google Slides.
  • مثال عملی: گزارش فروش فروردین ۱۴۰۴
  • نکته مهم: عنوان فایل می‌تواند با Expression ساخته شود؛ برای مثال ترکیب نام مشتری و تاریخ.

Page Object ID

  • نام پارامتر: Page Object ID
  • نوع داده: String
  • توضیح کاربرد: شناسه یک صفحه یا اسلاید خاص در ارائه است.
  • مثال عملی: برای دریافت Thumbnail اسلاید اول باید Page Object ID همان اسلاید را وارد کنید.
  • نکته مهم: Page Object ID با Presentation ID متفاوت است. Presentation ID مربوط به کل فایل است، اما Page Object ID مربوط به یک اسلاید خاص است.

Return All

  • نام پارامتر: Return All
  • نوع داده: Boolean
  • توضیح کاربرد: تعیین می‌کند همه نتایج برگردانده شوند یا فقط تعداد محدودی از آن‌ها.
  • مثال عملی: اگر می‌خواهید همه اسلایدهای یک ارائه دریافت شوند، مقدار آن را true قرار دهید.
  • نکته مهم: در فایل‌های بزرگ، دریافت همه داده‌ها می‌تواند باعث افزایش زمان اجرای ورکفلو شود.

Limit

  • نام پارامتر: Limit
  • نوع داده: Number
  • توضیح کاربرد: تعداد نتایجی که باید برگردانده شود را مشخص می‌کند.
  • مثال عملی: مقدار 10 برای دریافت فقط ۱۰ اسلاید یا آیتم اول.
  • نکته مهم: زمانی کاربرد دارد که Return All غیرفعال باشد.

Fields

  • نام پارامتر: Fields
  • نوع داده: String
  • توضیح کاربرد: برای محدودکردن فیلدهای خروجی API و بهینه‌سازی پاسخ استفاده می‌شود.
  • مثال عملی: presentationId,title,slides.objectId
  • نکته مهم: استفاده درست از Fields می‌تواند حجم خروجی و زمان اجرا را کاهش دهد.

Thumbnail Properties

  • نام پارامتر: Thumbnail Properties
  • نوع داده: گزینه انتخابی یا Object
  • توضیح کاربرد: برای تعیین مشخصات تصویر بندانگشتی اسلاید، مانند اندازه یا نوع MIME استفاده می‌شود.
  • مثال عملی: دریافت تصویر PNG از اسلاید اول برای ارسال در پیام Slack.
  • نکته مهم: لینک Thumbnail معمولاً موقتی است و ممکن است بعد از مدتی منقضی شود.

Text to Replace

  • نام پارامتر: Text to Replace
  • نوع داده: String
  • توضیح کاربرد: متن یا Placeholder موجود در اسلاید که باید جایگزین شود.
  • مثال عملی: {{customer_name}}
  • نکته مهم: بهتر است Placeholderها در قالب اسلاید کاملاً یکتا باشند تا متن اشتباهی جایگزین نشود.

Replacement Text

  • نام پارامتر: Replacement Text
  • نوع داده: String
  • توضیح کاربرد: متن جدیدی که به‌جای Placeholder یا متن قبلی قرار می‌گیرد.
  • مثال عملی: شرکت آریا پردازش
  • نکته مهم: این مقدار می‌تواند با Expression از خروجی نودهای قبلی خوانده شود؛ مثل {{$json.customerName}}.

Requests

  • نام پارامتر: Requests
  • نوع داده: Array / JSON
  • توضیح کاربرد: برای ارسال درخواست‌های پیشرفته به Google Slides API، مثل جایگزینی متن، ایجاد اسلاید، درج تصویر، حذف آبجکت یا تغییر قالب‌بندی استفاده می‌شود.
  • مثال عملی: ارسال یک درخواست replaceAllText برای جایگزینی {{date}} با تاریخ امروز.
  • نکته مهم: ساختار Requests باید مطابق مستندات رسمی Google Slides API باشد. کوچک‌ترین خطای ساختاری در JSON می‌تواند باعث خطای Bad Request شود.

Additional Fields

  • نام پارامتر: Additional Fields
  • نوع داده: Object
  • توضیح کاربرد: تنظیمات اختیاری عملیات را نگهداری می‌کند؛ مثل محدودکردن خروجی، تعیین فیلدهای خاص یا تنظیمات مرتبط با نوع عملیات.
  • مثال عملی: استفاده از Fields برای دریافت فقط عنوان و شناسه اسلایدها.

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

  • قبل از استفاده از نود، Google OAuth2 Credential را در بخش Credentials ایجاد کنید.
  • در Google Cloud Console باید APIهای موردنیاز، به‌خصوص Google Slides API و در برخی سناریوها Google Drive API فعال باشند.
  • اگر قرار است فایل قالب کپی شود، معمولاً به نود Google Drive هم نیاز دارید.
  • برای استفاده از Expressionها، مقدار فیلدها را از خروجی نودهای قبلی بخوانید.
  • برای فایل‌های اشتراکی، دسترسی حساب متصل‌شده به N8N را بررسی کنید.
  • برای عملیات پیچیده، ابتدا با یک فایل تست کار کنید و سپس ورکفلو را روی فایل اصلی اجرا کنید.

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

نود Google Slides معمولاً داده‌هایی مثل شناسه ارائه، شناسه اسلاید، متن جایگزین، عنوان فایل یا ساختار درخواست‌های JSON را به‌عنوان ورودی دریافت می‌کند و خروجی آن اطلاعات ارائه، اسلایدها، لینک‌ها، شناسه‌ها یا نتیجه اجرای عملیات است.

نمونه ورودی برای دریافت اطلاعات یک ارائه

{  "presentationId": "1AbCDeFG12345",  "fields": "presentationId,title,slides.objectId"}

نمونه خروجی دریافت ارائه

{  "presentationId": "1AbCDeFG12345",  "title": "گزارش فروش ماهانه",  "slides": [    {      "objectId": "p1",      "pageType": "SLIDE"    },    {      "objectId": "p2",      "pageType": "SLIDE"    }  ]}

نمونه ورودی برای ساخت ارائه جدید

{  "title": "پروپوزال شرکت آریا"}

نمونه خروجی ساخت ارائه جدید

{  "presentationId": "1ZXCVbnm98765",  "title": "پروپوزال شرکت آریا",  "slides": [    {      "objectId": "p1"    }  ]}

نمونه ورودی برای جایگزینی متن در قالب

{  "presentationId": "1AbCDeFG12345",  "requests": [    {      "replaceAllText": {        "containsText": {          "text": "{{customer_name}}",          "matchCase": true        },        "replaceText": "شرکت آریا پردازش"      }    },    {      "replaceAllText": {        "containsText": {          "text": "{{date}}",          "matchCase": true        },        "replaceText": "۱۴۰۴/۰۱/۲۵"      }    }  ]}

نمونه خروجی به‌روزرسانی ارائه

{  "presentationId": "1AbCDeFG12345",  "replies": [    {      "replaceAllText": {        "occurrencesChanged": 1      }    },    {      "replaceAllText": {        "occurrencesChanged": 1      }    }  ]}

نمونه ورودی از نودهای قبلی

اگر اطلاعات مشتری از یک CRM یا Google Sheets دریافت شود، ورودی می‌تواند به شکل زیر باشد:

{  "customerName": "شرکت آریا پردازش",  "projectTitle": "پیاده‌سازی سیستم اتوماسیون فروش",  "price": "۸۵۰,۰۰۰,۰۰۰ تومان",  "date": "۱۴۰۴/۰۱/۲۵"}

استفاده از Expression در N8N

در فیلد Replacement Text می‌توان از Expression استفاده کرد:

{{$json.customerName}}

یا برای ساخت عنوان ارائه:

پروپوزال {{$json.customerName}} - {{$now.format("yyyy-MM-dd")}}

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

استفاده از قالب‌های آماده

یکی از بهترین روش‌ها برای کار با Google Slides در N8N این است که یک فایل قالب طراحی شود و داخل آن Placeholderهایی مثل {{customer_name}}، {{price}}، {{date}} و {{project_title}} قرار بگیرد. سپس در ورکفلو، ابتدا با Google Drive یک کپی از قالب ساخته شود و بعد با Google Slides متن‌ها جایگزین شوند.

  • Google Drive: کپی‌کردن فایل قالب
  • Google Slides: جایگزینی Placeholderها
  • Gmail یا Slack: ارسال لینک فایل نهایی

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

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

presentationId,title,slides.objectId

ساخت چند درخواست در یک مرحله

به‌جای اجرای چندین نود Google Slides برای جایگزینی چند متن، می‌توان چند درخواست را در یک آرایه Requests ارسال کرد. این روش سریع‌تر، تمیزتر و بهینه‌تر است.

{  "requests": [    {      "replaceAllText": {        "containsText": {          "text": "{{name}}",          "matchCase": true        },        "replaceText": "علی رضایی"      }    },    {      "replaceAllText": {        "containsText": {          "text": "{{company}}",          "matchCase": true        },        "replaceText": "شرکت نمونه"      }    }  ]}

ترکیب با OpenAI یا سایر مدل‌های هوش مصنوعی

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

دریافت Thumbnail اسلایدها

برای نمایش پیش‌نمایش اسلایدها در پیام Slack، Telegram، ایمیل یا داشبورد داخلی، می‌توان از عملیات دریافت Thumbnail استفاده کرد. خروجی معمولاً شامل URL تصویر اسلاید است.

استفاده از HTTP Request برای عملیات پشتیبانی‌نشده

اگر عملیاتی در نود Google Slides به‌صورت مستقیم وجود نداشت، می‌توان از نود HTTP Request به همراه Google OAuth2 Credential استفاده کرد و مستقیماً به Google Slides API درخواست فرستاد. این روش برای سناریوهای پیشرفته مثل درج تصویر، تغییر استایل متن، ساخت Shape، تغییر Layout یا Duplicate Object کاربرد دارد.

مدیریت فایل‌های خروجی با Google Drive

Google Slides فایل را در Google Drive ذخیره می‌کند. بنابراین برای تغییر نام فایل، انتقال به پوشه مشخص، تنظیم Permission، دریافت لینک اشتراک‌گذاری یا کپی‌کردن قالب‌ها، معمولاً باید نود Google Drive را در کنار Google Slides استفاده کرد.

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

محدودیت‌های نود Google Slides

  • این نود Trigger نیست و به‌صورت خودکار با تغییر فایل Google Slides اجرا نمی‌شود.
  • برای تشخیص تغییرات فایل باید از روش‌هایی مثل زمان‌بندی با Schedule Trigger، بررسی Google Drive یا Webhookهای سفارشی استفاده شود.
  • همه قابلیت‌های Google Slides API ممکن است به‌صورت مستقیم در رابط گرافیکی نود وجود نداشته باشد.
  • برای عملیات پیشرفته ممکن است نیاز به استفاده از Requests JSON یا نود HTTP Request باشد.
  • دسترسی به فایل‌ها وابسته به مجوز حساب گوگل متصل‌شده است.
  • لینک Thumbnail ممکن است دائمی نباشد و بعد از مدتی منقضی شود.
  • در فایل‌های بزرگ، دریافت همه اسلایدها یا آبجکت‌ها می‌تواند باعث کندی اجرای ورکفلو شود.
  • Google API دارای محدودیت نرخ درخواست و سهمیه مصرف است.

خطای 401 Unauthorized

این خطا معمولاً به معنی مشکل در احراز هویت است.

  • علت احتمالی: Credential منقضی شده یا به‌درستی تنظیم نشده است.
  • راه‌حل: Credential گوگل را دوباره متصل کنید و مطمئن شوید Scopeهای لازم فعال هستند.

خطای 403 Forbidden

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

  • علت احتمالی: فایل با حساب گوگل N8N به اشتراک گذاشته نشده است.
  • راه‌حل: فایل را با همان حساب گوگل Share کنید یا مالکیت و سطح دسترسی را بررسی کنید.

خطای 404 Not Found

این خطا معمولاً مربوط به شناسه اشتباه فایل یا اسلاید است.

  • علت احتمالی: Presentation ID یا Page Object ID اشتباه وارد شده است.
  • راه‌حل: شناسه را از URL فایل یا خروجی نود Get بررسی کنید.

خطای 400 Bad Request

این خطا بیشتر در عملیات به‌روزرسانی یا ارسال Requests رخ می‌دهد.

  • علت احتمالی: ساختار JSON اشتباه است یا یکی از فیلدهای الزامی وجود ندارد.
  • راه‌حل: JSON را با مستندات رسمی Google Slides API تطبیق دهید و ابتدا با یک درخواست ساده تست کنید.

خطای Quota Exceeded

این خطا زمانی اتفاق می‌افتد که تعداد درخواست‌ها به API از محدودیت مجاز عبور کند.

  • علت احتمالی: اجرای زیاد ورکفلو یا ارسال درخواست‌های تکراری برای هر آیتم.
  • راه‌حل: از Batch Update استفاده کنید، تعداد درخواست‌ها را کاهش دهید و در صورت نیاز از Wait یا Rate Limit استفاده کنید.

جایگزین‌نشدن متن در اسلاید

گاهی عملیات بدون خطا اجرا می‌شود اما متن جایگزین نمی‌شود.

  • علت احتمالی: Placeholder دقیقاً با متن داخل اسلاید برابر نیست.
  • راه‌حل: فاصله‌ها، حروف بزرگ و کوچک، کاراکترهای فارسی و علائم را بررسی کنید. اگر matchCase فعال است، حساسیت به حروف را در نظر بگیرید.

ایده ها

  • پروپوزال‌ساز خودکار: دریافت اطلاعات مشتری از فرم یا CRM، کپی قالب Google Slides، جایگزینی اطلاعات و ارسال لینک نهایی به تیم فروش.
  • گزارش مدیریتی هفتگی: جمع‌آوری داده از Google Sheets، دیتابیس و ابزارهای تحلیلی، سپس ساخت ارائه برای جلسه هفتگی مدیران.
  • تولید اسلاید آموزشی با هوش مصنوعی: دریافت موضوع درس، تولید سرفصل‌ها با AI و ساخت اسلایدهای اولیه در Google Slides.
  • خلاصه جلسه به شکل ارائه: دریافت متن جلسه از ابزارهای Transcription، خلاصه‌سازی با AI و قراردادن نکات کلیدی در قالب اسلاید.
  • ساخت گزارش کمپین تبلیغاتی: دریافت داده از Google Ads، Meta Ads یا ابزارهای مارکتینگ و تولید خودکار گزارش اسلایدی برای مشتری.

منابع و مستندات اصلی

دسته بندی: N8N برچسب ها:

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

نوزده − 16 =