عملکرد سفارشی شروع سریع

می‌توانید از Google Apps Script برای نوشتن یک عملکرد سفارشی استفاده کنید، سپس از آن در Google Sheets درست مانند یک عملکرد داخلی استفاده کنید.

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

اهداف

  • اسکریپت را تنظیم کنید
  • اسکریپت را اجرا کنید.

پیش نیازها

برای استفاده از این نمونه به پیش نیازهای زیر نیاز دارید:

  • یک حساب Google (حساب‌های Google Workspace ممکن است به تأیید سرپرست نیاز داشته باشند).
  • یک مرورگر وب با دسترسی به اینترنت.

اسکریپت را تنظیم کنید

  1. یک صفحه گسترده جدید ایجاد کنید.
  2. از داخل صفحه‌گسترده جدید، مورد منو Extensions > Apps Script را انتخاب کنید.

  3. هر کدی را در ویرایشگر اسکریپت حذف کنید و کد زیر را جایگذاری کنید. سپس روی ذخیره کلیک کنید نماد ذخیره . 

    /**
 * Calculates the sale price of a value at a given discount.
 * The sale price is formatted as US dollars.
 *
 * @param {number} input The value to discount.
 * @param {number} discount The discount to apply, such as .5 or 50%.
 * @return The sale price formatted as USD.
 * @customfunction
 */
function salePrice(input, discount) {
  let price = input - (input * discount);
  let dollarUS = Intl.NumberFormat("en-US", {
    style: "currency",
    currency: "USD",
});
  return dollarUS.format(price);
}

اسکریپت را اجرا کنید

  1. به صفحه گسترده خود برگردید.
  2. در یک سلول، =salePrice(100,.2) وارد کنید. پارامتر اول نشان دهنده قیمت اصلی و پارامتر دوم نشان دهنده درصد تخفیف است. اگر در مکانی هستید که از کاماهای اعشاری استفاده می کند، ممکن است لازم باشد =salePrice(100;0,2) وارد کنید.

فرمولی که در سلول وارد می‌کنید تابع اسکریپتی را که در بخش قبلی ایجاد کرده‌اید اجرا می‌کند. عملکرد منجر به قیمت فروش $80.00 می شود.

مراحل بعدی

برای ادامه یادگیری نحوه گسترش Sheets با Apps Script، به منابع زیر نگاهی بیندازید: