Hướng dẫn tạo API lấy dữ liệu từ google sheet

Bài đăng này đã không được cập nhật trong 4 năm

Hôm trước mình có viết 1 bài Hướng dẫn tạo API ghi dữ liệu lên google sheet, thì nay mình tiếp tục chia sẻ cho mọi người cách để lấy dữ liệu từ google sheet thông qua api. Bài toán hôm nay của mình là muốn lấy thông tin thành viên của dự án trên google sheet để xử lý 1 số tác vụ bằng code, thông tin nhạy cảm nên mình sẽ dùng dữ liệu demo thôi nhé mọi người.

Thiết lập google sheet

Đầu tiên chúng ta cần tạo 1 trang google sheets, bạn nào có rồi có thể bỏ qua bước này, truy cập đường dẫn: https://docs.google.com/spreadsheets/ sẽ mở trang google sheet giao diện như bên dưới sau đó chọn "Blank"

Sau khi tạo trang google sheets xong, chúng ta thêm dữ liệu vào sheet như ảnh dưới (vị trí để giống mình là được còn màu thì mình thêm vào để highlight thôi chứ không cần)

Thiết lập google script

Thêm dữ liệu vào sheet xong chúng ta sẽ đi viết script để lấy dữ liệu ra, mình sẽ lấy toàn bộ nội dung bôi đỏ ở ảnh trên, trên thanh công cụ chọn Tools -> Script editor

Trình duyệt sẽ mở 1 tab google script

Thay đoạn code trong phần Code.gs thành nội dung sau

function doGet(e) {
    return handleResponse(e);
}

var SHEET_NAME = "Sheet1";

var SCRIPT_PROP = PropertiesService.getScriptProperties();

function handleResponse(e) {
    var lock = LockService.getPublicLock();
    lock.waitLock(30000);

    try {
        var doc = SpreadsheetApp.openById(SCRIPT_PROP.getProperty("key"));
        var sheet = doc.getSheetByName(SHEET_NAME);

        var row = 2;
        var column = 3;
        var numRows = 4;
        var numColumns = 1;
      
        var values = sheet.getRange(row, column, numRows, numColumns).getValues();
      
        var names = [];
      
        for (var row in values) {
            if (values[row][0]) {
                names.push(values[row][0]);
            }
        }
      
        var content = {
            "names": names,
        };

        return ContentService
            .createTextOutput(JSON.stringify({"result": "success", "content": content}))
            .setMimeType(ContentService.MimeType.JSON);
    } catch (e) {
        return ContentService
            .createTextOutput(JSON.stringify({"result": "error", "error": e}))
            .setMimeType(ContentService.MimeType.JSON);
    } finally {
        lock.releaseLock();
    }
}

function setup() {
    var doc = SpreadsheetApp.getActiveSpreadsheet();
    SCRIPT_PROP.setProperty("key", doc.getId());
}

SHEET_NAME chính là tên của sheet bên trang google sheet, mặc định khi tạo mới sẽ là "Sheet1"

Để lấy giá trị mình dùng hàm getRange, hàm này nhận vào 4 tham số

row: hàng bắt đầu
column: cột bắt đầu
numRows: số hàng muốn lấy
numColumns: số cột muốn lấy

Bài toán của mình là lấy từ cột C2 đến C5 (phần bôi màu đỏ trên sheet) thì sẽ truyền vào hàm getRange lần lượt là

row = 2 (lấy từ giá trị A nên hàng bắt đầu sẽ bằng 2)
column = 3 (lấy giá trị ở cột C tương ứng sẽ là 3)
numRows = 4 (mình muốn lấy hàng 2, 3, 4, 5 nên số hàng sẽ bằng 4)
numColumns = 1 (mình chỉ muốn lấy nguyên cột C nên số cột bằng 1)

Lấy dữ liệu bằng hàm getRange thì mảng trả về sẽ có dạng như dưới, mọi người dùng cú pháp ngôn ngữ javascript để xử lý mảng theo ý mình mong muốn nhé

values = [
    ['A'],
    ['B'],
    ['C'],
    ['D'],
];

Ở trên thì mình xử lý như sau

var row = 2;
var column = 3;
var numRows = 4;
var numColumns = 1;

var values = sheet.getRange(row, column, numRows, numColumns).getValues();
      
var names = [];
      
for (var row in values) {
    if (values[row][0]) {
        names.push(values[row][0]);
    }
}