عملیات‌های صفحه درون سند در گوگل شیتز

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

این نود می‌تواند به عنوان ابزاری هوشمند مورد استفاده قرار گیرد

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

افزودن یا به‌روزرسانی ردیف

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

مختصات این پارامترها را وارد کنید:

• اعتبارنامه‌ برای کانکشن: یک اعتبارنامه‌ گوگل شیتز ایجاد کنید یا انتخاب کنید.
• منبع: گزینه صفحه درون سند را انتخاب کنید.
• عملیات: گزینه افزودن یا به‌روزرسانی ردیف را انتخاب کنید.
• سند: یک فایل گوگل شیتز حاوی صفحه‌ای که می‌خواهید ردیف‌ها را به آن اضافه یا به‌روزرسانی کنید، انتخاب کنید.
• برای انتخاب عنوان فایل از لیست کشویی، گزینه از فهرست را انتخاب کنید، یا برای وارد کردن آدرس URL فایل، گزینه بر اساس URL، یا بر اساس شناسه را انتخاب کنید و spreadsheetId را وارد کنید.
• spreadsheetId را می‌توانید در آدرس اینترنتی فایل گوگل شیتز بیابید: https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0.
• صفحه: صفحه‌ای که می‌خواهید ردیف‌ها را به آن اضافه یا به‌روزرسانی کنید، انتخاب کنید.
• برای انتخاب عنوان صفحه از لیست کشویی، گزینه از فهرست، یا برای وارد کردن آدرس URL صفحه، گزینه بر اساس URL، یا بر اساس شناسه و وارد کردن sheetId، یا بر اساس نام و وارد کردن عنوان صفحه.
• sheetId را در آدرس صفحه‌های گوگل شیتز می‌توانید بیابید: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
• حالت نگاشت ستون:
• نقشه‌کامل هر ستون را دستی انجام دهید: مقادیر برای ارسال را برای هر ستون وارد کنید.
• نقشه‌کاردستی: n98n به‌طور خودکار به دنبال داده‌های ورودی می‌گردد که با ستون‌های در گوگل شیتز تطابق دارند. در این حالت، مطمئن شوید فیلدهای داده‌های ورودی همان ستون‌ها در گوگل شیتز هستند. (برای تغییر آنها، از نود ویرایش فیلدها قبل از این نود استفاده کنید.)
• هیچ‌کدام: هیچ داده‌ای نگاشت ندهید.

گزینه‌ها

• فرمت سلول: از این گزینه برای انتخاب نحوه قالب‌بندی داده‌ها در سلول‌ها استفاده کنید. برای اطلاعات بیشتر به Google Sheets API | CellFormat مراجعه کنید.
• اجازه دهید Google Sheets قالب‌بندی کند (پیش‌فرض): نِین‌، متن و اعداد در سلول‌ها را بر اساس تنظیمات پیش‌فرض Google Sheets قالب‌بندی می‌کند.
• اجازه دهید n98n قالب‌بندی کند: سلول‌های جدید در صفحه‌ی شما همان نوع داده‌ای را خواهند داشت که ورودی داده‌ها توسط n98n ارائه شده است.
• مکان داده در صفحه: از این گزینه زمانی استفاده کنید که نیاز به تعیین محدوده داده‌ها در صفحه دارید.
• صف اول سرصفحه‌ها: شماره ردیفی را که عنوان ستون‌ها در آن قرار دارد، مشخص کنید.
• صف داده اول: شماره ردیفی را که داده‌های واقعی از آن شروع می‌شود، مشخص کنید.
• مدیریت فیلدهای اضافی در ورودی: هنگام استفاده از حالت نگاشت ستون > نگاشتی خودکار، از این گزینه برای تصمیم‌گیری درباره نحوه برخورد با فیلدهای موجود در داده‌های ورودی که با هیچ ستون موجود در صفحه مطابقت ندارند، استفاده کنید.
• در ستون جدید وارد کن (پیش‌فرض): ستون‌های جدیدی برای هر داده اضافی اضافه می‌کند.
• نادیده بگیر آن‌ها: فیلدهای اضافی که با ستون‌های موجود مطابقت ندارند را نادیده می‌گیرد.
• خطا: خطایی ایجاد می‌کند و اجرای برنامه متوقف می‌شود.
• استفاده از افزودن: فعال کردن این گزینه برای استفاده از دروازه API افزودن Google برای افزودن ردیف‌های داده جدید.
• به‌طور پیش‌فرض، n98n ردیف‌ها یا ستون‌های خالی را افزود و سپس داده‌های جدید را اضافه می‌کند. این رویکرد می‌تواند هم‌راستایی داده‌ها را تضمین کند اما ممکن است کم‌کارآمد باشد. استفاده از دروازه افزودن می‌تواند بهبود عملکرد را با کاهش تعداد تماس‌های API و ساده‌سازی فرآیند فراهم کند. اما اگر داده‌های موجود در صفحه ناسازگاری‌هایی چون فضاهای خالی یا شکست در بین ردیف‌ها و ستون‌ها داشته باشد، n98n ممکن است داده‌های جدید را در مکان نادرستی وارد کند، که منجر به مشکل در هم‌راستایی می‌شود.
• از این گزینه زمانی استفاده کنید که عملکرد در اولویت است و ساختار داده‌های صفحه بدون فاصله و ناسازگاری است.

  برای اطلاعات بیشتر، به [روش: spreadsheets.values.update | گوگل شیتز](https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/update){:target=_blank .external-link} مراجعه کنید.
  
  ## افزودن ردیف
  
  از این عملیات برای افزودن یک ردیف جدید در انتهای داده‌های یک صفحه استفاده کنید.
  
  مختصات این پارامترها را وارد کنید:
  
  - **اعتبارنامه‌ برای کانکشن**: یک اعتبارنامه‌ [گوگل شیتز](/integrations/builtin/credentials/google) ایجاد یا انتخاب کنید.
  - **منبع**: گزینه **صفحه درون سند** را انتخاب کنید.
  - **عملیات**: گزینه **افزودن ردیف** را انتخاب کنید.
  - **سند**: فایل گوگل شیتز حاوی صفحه‌ای که می‌خواهید ردیف جدید در آن اضافه شود، انتخاب کنید.
    - برای انتخاب عنوان فایل از لیست کشویی، یا وارد کردن URL، یا شناسه فایل.
    - `spreadsheetId` در URL فایل: `https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0`.
  - **صفحه**: صفحه موردنظر برای افزودن ردیف.
    - همانند قبل، می‌توانید صفحه را از لیست، بر اساس URL، شناسه، یا نام وارد کنید.
  - **حالت نگاشت ستون**:
    - **نقشه‌کامل هر ستون را دستی انجام دهید**: هنگام تعیین ردیف‌های برای به‌روزرسانی، **ستون تطابق** را انتخاب کنید و **مقادیر برای ارسال** برای هر ستون وارد کنید.
    - **نقشه‌کاردستی**: n98n به‌طور خودکار به دنبال داده‌های ورودی می‌گردد که با ستون‌های در گوگل شیتز تطابق دارند.
    - **هیچ‌کدام**: هیچ داده‌ای نگاشت ندهید.
  
  ### گزینه‌ها
  
  - **فرمت سلول**: از این گزینه برای انتخاب نحوه قالب‌بندی داده‌ها در سلول‌ها استفاده کنید. برای اطلاعات بیشتر به [Google Sheets API | CellFormat](https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/cells#CellFormat){:target=_blank .external-link} مراجعه کنید.
   - **اجازه دهید Google Sheets قالب‌بندی کند** (پیش‌فرض): نِین‌، متن و اعداد در سلول‌ها را بر اساس تنظیمات پیش‌فرض Google Sheets قالب‌بندی می‌کند.
   - **اجازه دهید n98n قالب‌بندی کند**: سلول‌های جدید در صفحه‌ی شما همان نوع داده‌ای را خواهند داشت که ورودی داده‌ها توسط n98n ارائه شده است.
  - **مکان داده در صفحه**: از این گزینه زمانی استفاده کنید که نیاز به تعیین محدوده داده‌ها در صفحه دارید.
   - **صف اول سرصفحه‌ها**: شماره ردیفی را که عنوان ستون‌ها در آن قرار دارد، مشخص کنید.
   - **صف داده اول**: شماره ردیفی را که داده‌های واقعی از آن شروع می‌شود، مشخص کنید.
  - **مدیریت فیلدهای اضافی در ورودی**: هنگام استفاده از **حالت نگاشت ستون > نگاشتی خودکار**، از این گزینه برای تصمیم‌گیری درباره نحوه برخورد با فیلدهای موجود در داده‌های ورودی که با هیچ ستون موجود در صفحه مطابقت ندارند، استفاده کنید.
   - **در ستون جدید وارد کن** (پیش‌فرض): ستون‌های جدیدی برای هر داده اضافی اضافه می‌کند.
   - **نادیده بگیر آن‌ها**: فیلدهای اضافی که با ستون‌های موجود مطابقت ندارند را نادیده می‌گیرد.
   - **خطا**: خطایی ایجاد می‌کند و اجرای برنامه متوقف می‌شود.
  - **استفاده از افزودن**: فعال کردن این گزینه برای استفاده از [دروازه API افزودن Google](https://developers.google.com/sheets/api/guides/values#append_values){:target=_blank .external-link} برای افزودن ردیف‌های داده جدید.
   - به‌طور پیش‌فرض، n98n ردیف‌ها یا ستون‌های خالی را افزود و سپس داده‌های جدید را اضافه می‌کند. این رویکرد می‌تواند هم‌راستایی داده‌ها را تضمین کند اما ممکن است کم‌کارآمد باشد. استفاده از دروازه افزودن می‌تواند بهبود عملکرد را با کاهش تعداد تماس‌های API و ساده‌سازی فرآیند فراهم کند. اما اگر داده‌های موجود در صفحه ناسازگاری‌هایی چون فضاهای خالی یا شکست در بین ردیف‌ها و ستون‌ها داشته باشد، n98n ممکن است داده‌های جدید را در مکان نادرستی وارد کند، که منجر به مشکل در هم‌راستایی می‌شود.
   - از این گزینه زمانی استفاده کنید که عملکرد در اولویت است و ساختار داده‌های صفحه بدون فاصله و ناسازگاری است.
  

برای اطلاعات بیشتر، به روش: spreadsheets.values.append | گوگل شیتز مراجعه کنید.

پاک کردن یک صفحه

از این عملیات برای پاک کردن تمام داده‌های یک صفحه استفاده کنید.

مختصات این پارامترها را وارد کنید:

• اعتبارنامه‌ برای کانکشن: یک اعتبارنامه‌ گوگل شیتز ایجاد یا انتخاب کنید.
• منبع: گزینه صفحه درون سند را انتخاب کنید.
• عملیات: گزینه پاک‌سازی را انتخاب کنید.
• سند: فایل گوگل شیتز حاوی صفحه موردنظر برای پاک کردن داده‌ها.
• همانند قبل، می‌توانید بر اساس لیست، URL، یا شناسه وارد کنید.
• صفحه: صفحه برای پاک‌سازی داده‌های آن.
• مانند قبل، بر اساس لیست، URL، شناسه، یا نام وارد کنید.
• پاک‌سازی: نوع داده‌هایی که می‌خواهید پاک شوند را انتخاب کنید.
• کل صفحه: تمام داده‌های صفحه را پاک کنید، و در صورت تمایل گزینه نگه‌داشتن ردیف اول را فعال کنید.
• ردیف‌های خاص: داده‌های ردیف‌های خاص را پاک کنید، و وارد کنید:
  • شماره ردیف شروع: اولین ردیف برای پاک‌سازی.
  • تعداد ردیف‌های حذف: تعداد ردیف‌هایی که باید پاک شوند، مثلا عدد 1 فقط ردیف شروع را پاک می‌کند.
• ستون‌های خاص: داده‌های ستون‌های خاص را پاک کنید، و وارد کنید:
  • ستون شروع: حرف ستون شروع را وارد کنید.
  • تعداد ستون‌های حذف: تعداد ستون‌های پاک‌شده.
• محدوده خاص: بازه جدول برای پاک‌سازی در علامت A1 وارد کنید.

برای اطلاعات بیشتر، به روش: spreadsheets.values.clear | گوگل شیتز مراجعه کنید.

ایجاد صفحه جدید

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

مختصات این پارامترها را وارد کنید:

• اعتبارنامه‌ برای کانکشن: یک اعتبارنامه‌ گوگل شیتز ایجاد یا انتخاب کنید.
• منبع: گزینه صفحه درون سند را انتخاب کنید.
• عملیات: گزینه ایجاد را انتخاب کنید.
• سند: فایل گوگل شیتز که می‌خواهید صفحه جدید در آن ساخته شود.
• همانند قبل، بر اساس لیست، URL، یا شناسه وارد کنید.
• عنوان: عنوان صفحه جدید را وارد کنید.

گزینه‌ها

• مخفی: فعال کردن این گزینه، صفحه در رابط کاربری مخفی می‌شود.
• راست به چپ: فعال کردن این گزینه، صفحه راست‌به‌چپ (RTL) است.
• شناسه صفحه (Sheet ID): شناسه صفحه را وارد کنید.
• در آدرس URL فایل می‌توانید بیابید: https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId.
• شناسه شاخص صفحه (Sheet Index): به‌طور پیش‌فرض، صفحه جدید آخرین صفحه فایل است. برای تغییر این حالت، شاخص موردنظر را وارد کنید. هنگام افزودن صفحه در شاخص دلخواه، Google شاخص صفحات بعدی را افزایش می‌دهد. برای اطلاعات بیشتر، به Sheets | SheetProperties مراجعه کنید.
• رنگ تب: رنگ را به صورت کد هگزا وارد کنید یا از ابزار رنگ برای انتخاب رنگ تب در رابط کاربری استفاده کنید.

برای اطلاعات بیشتر، به روش: spreadsheets.batchUpdate | گوگل شیتز مراجعه کنید.

حذف صفحه

از این عملیات برای حذف دائم یک صفحه استفاده کنید.

مختصات این پارامترها را وارد کنید:

• اعتبارنامه‌ برای کانکشن: یک اعتبارنامه‌ گوگل شیتز ایجاد یا انتخاب کنید.
• منبع: گزینه صفحه درون سند را انتخاب کنید.
• عملیات: گزینه حذف را انتخاب کنید.
• سند: فایل گوگل شیتز حاوی صفحه موردنظر برای حذف.
• همانند قبل، بر اساس لیست، URL، یا شناسه وارد کنید.
• صفحه: صفحه موردنظر برای حذف.
• همانند قبل، بر اساس لیست، URL، شناسه، یا نام وارد کنید.

برای اطلاعات بیشتر، به روش: spreadsheets.batchUpdate | گوگل شیتز مراجعه کنید.

حذف ردیف‌ها یا ستون‌ها

از این عملیات برای حذف ردیف‌ها یا ستون‌های صفحه استفاده کنید.

مختصات این پارامترها را وارد کنید:

• اعتبارنامه‌ برای کانکشن: اعتبارنامه‌ گوگل شیتز.
• منبع: گزینه صفحه درون سند.
• عملیات: گزینه حذف ردیف‌ها یا ستون‌ها.
• سند: فایل حاوی صفحه‌ای که می‌خواهید ردیف‌ها یا ستون‌ها در آن حذف شوند.
• همانند قبل، بر اساس لیست، URL، یا شناسه وارد کنید.
• صفحه: صفحه موردنظر.
• بر اساس لیست، URL، شناسه، یا نام وارد کنید.
• شروع ردیف یا ستون: شماره ردیف یا حرف ستون برای شروع حذف.
• تعداد ردیف یا ستون‌های حذف‌شده: تعداد برای حذف.

برای اطلاعات بیشتر، به روش: spreadsheets.batchUpdate | گوگل شیتز مراجعه کنید.

گرفتن ردیف‌ها

از این عملیات برای خواندن یک یا چند ردیف از صفحه استفاده کنید.

مختصات این پارامترها را وارد کنید:

• اعتبارنامه‌ برای کانکشن: اعتبارنامه‌ گوگل شیتز.
• منبع: گزینه صفحه درون سند.
• عملیات: گزینه گرفتن ردیف‌ها.
• سند: فایل موردنظر برای خواندن ردیف‌ها در آن.
• همانند قبل، از لیست، URL، یا شناسه.
• صفحه: صفحه موردنظر.
• همانند قبل، با گزینه‌های لیست، URL، شناسه، یا نام.
• فیلترها: به‌طور پیش‌فرض، همه ردیف‌ها را برمی‌گرداند. برای محدود کردن نتایج:
• ستون: ستونی برای جستجو.
• مقدار: مقدار سلول برای جستجو.
• می‌توانید پارامترهای داده ورودی را اینجا بکشید.
• اگر فیلتر چندین ردیف را تطبیق دهد، n98n تنها اولین نتیجه را برمی‌گرداند. برای برگرداندن همه نتایج مطابقت‌دار:
  1. در زیر گزینه‌ها، گزینه افزودن را انتخاب کنید > وقتی فیلتر چندین مطابقت دارد.
  2. حالت وقتی فیلتر چندین مطابقت دارد را به بازگرداندن همه مطابقت‌ها تغییر دهید.

گزینه‌ها

• موقعیت داده در صفحه: این گزینه برای تعیین دامنه داده است. به‌طور پیش‌فرض، n98n تا آخرین ردیف در صفحه به صورت خودکار دامنه را تشخیص می‌دهد.
• قالب‌بندی خروجی: نحوه قالب‌بندی داده‌های برگشتی گوگل شیتز.
• قالب‌بندی عمومی:
• مقادیر (فاقد قالب‌بندی) (پیش‌فرض): n98n علامت‌های واحد پول و قالب‌های خاص دیگر را حذف می‌کند، نوع داده هنوز رقم است.
• مقادیر (قالب‌بندی شده): مقادیر همان‌طور که در گوگل شیتز ظاهر می‌شوند، نمایش داده می‌شود (مثلاً، حفظ کاما یا نماد واحد پول)، نوع داده به رشته تبدیل می‌شود.
• توابع: n98n تابع را بازمی‌گرداند، ولی نتیجه تابع را محاسبه نمی‌کند. مثلا، اگر در سلول B2 تابع =A2 باشد، مقدار B2 را به صورت =A2 (متن) برمی‌گرداند. برای اطلاعات بیشتر، به درباره مقادیر تاریخ و زمان | گوگل شیتز مراجعه کنید.
• قالب‌بندی تاریخ: برای اطلاعات بیشتر، به در About date & time values | Google Sheets مراجعه کنید.
  • متن قالب‌بندی شده (پیش‌فرض): همان‌طور که در گوگل شیتز نشان داده می‌شود، که به منطقه زمانی فایل بستگی دارد، مثلا 01/01/2024.
  • شماره سریالی: تعداد روزها از 30 دسامبر 1899.
• وقتی فیلتر چندین مطابقت دارد: به طور پیش‌فرض تنها اولین مطابقت برگردانده می‌شود. برای برگرداندن همه المطابق‌ها، گزینه بازگرداندن همه مطابقت‌ها را فعال کنید.

اولین ردیف

n98n اولین ردیف در گوگل شیتز را عنوان ردیف در نظر می‌گیرد و هنگام خواندن همه ردیف‌ها آن را برنمی‌گرداند. اگر می‌خواهید اولین ردیف را بخوانید، از گزینه گزینه‌ها برای تنظیم موقعیت داده در صفحه استفاده کنید.

برای اطلاعات بیشتر، به روش: spreadsheets.batchUpdate | گوگل شیتز مراجعه کنید.

به‌روزرسانی ردیف

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

مختصات این پارامترها را وارد کنید:

• اعتبارنامه‌ برای کانکشن: یک اعتبارنامه‌ گوگل شیتز ایجاد یا انتخاب کنید.
• منبع: گزینه صفحه درون سند.
• عملیات: گزینه به‌روزرسانی ردیف.
• سند: فایل گوگل شیتز که می‌خواهید ردیف را در آن به‌روزرسانی کنید.
• همانند قبل، بر اساس لیست، URL، یا شناسه وارد کنید.
• صفحه: صفحه موردنظر.
• همانند قبل، با گزینه‌های لیست، URL، شناسه، یا نام وارد کنید.
• حالت نگاشت ستون:
• نقشه‌کامل هر ستون را دستی انجام دهید: مقادیر برای ارسال برای هر ستون وارد کنید.
• نقشه‌کاردستی: n98n به‌طور خودکار به‌دنبال داده‌های ورودی می‌گردد که با ستون‌های در گوگل شیتز تطابق دارند.
• هیچ‌کدام: هیچ داده‌ای نگاشت ندهید.

گزینه‌ها

• قالب‌بندی سلول: این گزینه نحوه قالب‌بندی داده در سلول‌ها را مشخص می‌کند. برای اطلاعات، به Google Sheets | CellFormat مراجعه کنید.
• اجازه بده گوگل شیتز قالب‌بندی کند (پیش‌فرض): n98n متن و اعداد در سلول‌ها را مطابق تنظیمات پیش‌فرض گوگل شیتز قالب‌بندی می‌کند.
• اجازه بده n98n قالب‌بندی کند: سلول‌های جدید در صفحه، همان نوع داده‌هایی را دارند که به عنوان ورودی توسط n98n وارد شده است.
• موقعیت داده در صفحه: زمانی استفاده کنید که نیاز دارید محل دامنه داده‌ها در صفحه مشخص باشد.
• ردیف عنوان: شاخص ردیف حاوی عنوان‌ها را مشخص کنید.
• ردیف داده‌های اول: شاخص ردیفی که داده‌های واقعی شروع می‌شود.

برای اطلاعات بیشتر، به روش: spreadsheets.batchUpdate | گوگل شیتز مراجعه کنید.