Tự xây dựng hàm trong Apps Script

1. Cấu trúc của một hàm
   • Ví dụ hàm đơn giản in ra dòng chữ
   • Ví dụ hàm sử dụng tham số
   • Ví dụ Hàm trả về giá trị
   • Ví dụ hàm sử dụng Google Sheets API
2. Cách gọi hàm trong Google Apps Script
   • Bạn có thể chạy hàm trực tiếp từ trình soạn thảo script.
   • Gọi qua sự kiện và Trigger
3. Lợi ích của hàm (function)

Hàm (function) là một khái niệm cơ bản trong lập trình, được sử dụng để tổ chức và tái sử dụng mã nguồn một cách hiệu quả. Một hàm là một đoạn mã độc lập thực hiện một tác vụ cụ thể và có thể được gọi nhiều lần trong chương trình.

1. Cấu trúc của một hàm

function tenHam() {
  // Mã thực thi của hàm
}

Một hàm (function) bao gồm ba phần chính:

• Tên hàm: Là cách gọi hàm. Tên này phải duy nhất và tuân theo quy tắc đặt tên trong ngôn ngữ lập trình.
• Tham số (Parameters): Là các giá trị được truyền vào hàm để hàm có thể xử lý. Tham số có thể là bất kỳ kiểu dữ liệu nào, ví dụ như số, chuỗi, mảng, vv.
• Giá trị trả về (Return value): Là kết quả mà hàm trả về sau khi hoàn thành công việc. Một số hàm không có giá trị trả về, gọi là "void function".

Ví dụ hàm đơn giản in ra dòng chữ

function sayHello() {
  Logger.log("Hello, World!");
}

Khi chạy hàm sayHello, kết quả sẽ xuất hiện trong Logger, và bạn có thể xem nó trong phần Logs.

Ví dụ hàm sử dụng tham số

Bạn có thể truyền tham số vào hàm để làm việc với dữ liệu động.

function greetUser(name) {
  Logger.log("Hello, " + name + "!");
}

Khi gọi hàm greetUser("Alice"), kết quả trong Logs sẽ là: "Hello, Alice!".

Ví dụ Hàm trả về giá trị

Hàm có thể trả về một giá trị khi thực thi xong.

function addNumbers(a, b) {
  return a + b;
}

Khi gọi hàm addNumbers(3, 5), hàm sẽ trả về giá trị 8.

Ví dụ hàm sử dụng Google Sheets API

Apps Script rất mạnh mẽ trong việc tương tác với các ứng dụng Google. Dưới đây là ví dụ về hàm sử dụng Google Sheets API để ghi giá trị vào một ô.

function writeToSheet() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  sheet.getRange("A1").setValue("Hello, Google Sheets!");
}

Khi chạy hàm writeToSheet, nó sẽ ghi chữ "Hello, Google Sheets!" vào ô A1 của bảng tính hiện tại.

2. Cách gọi hàm trong Google Apps Script

Bạn có thể chạy hàm trực tiếp từ trình soạn thảo script.

   Các hàm có thể được gọi tự động, chẳng hạn như khi kích hoạt một sự kiện (nhấn nút trong trang tính, gửi email, vv.).

Gọi qua sự kiện và Trigger

Bạn cũng có thể gắn các hàm với các sự kiện (trigger).

Ví dụ, bạn có thể tạo một trigger để hàm chạy khi có sự kiện mới xảy ra (ví dụ, khi chỉnh sửa bảng tính, khi mở một tài liệu, vv.).

function onEdit(e) {
  var sheet = e.source.getActiveSheet();
  Logger.log('Cell edited: ' + sheet.getActiveCell().getA1Notation());
}

3. Mục đích và lợi ích của hàm

    Tái sử dụng mã: Bạn có thể gọi một hàm nhiều lần mà không cần phải viết lại mã.
    Tổ chức mã nguồn: Hàm giúp chia nhỏ các tác vụ lớn thành các phần nhỏ, dễ quản lý và hiểu hơn.
    Cải thiện khả năng bảo trì: Khi có lỗi, bạn chỉ cần chỉnh sửa trong hàm thay vì tìm kiếm và chỉnh sửa toàn bộ chương trình.
    Tính mô-đun: Các hàm có thể độc lập và được tái sử dụng trong các dự án khác nhau.