- Apps Script gọi được API của bất kỳ hãng AI nào bằng UrlFetchApp; khóa API cất trong Script Properties, không viết thẳng vào code.
- Hạn mức với tài khoản cá nhân: mỗi lần chạy tối đa 6 phút, tổng thời gian chạy bằng trình kích hoạt 90 phút mỗi ngày, 20.000 lần gọi UrlFetch mỗi ngày (Google Workspace: 6 giờ và 100.000).
- Bảng lớn phải chia thành nhiều lần chạy: đánh dấu hàng đã xử lý, rồi để trình kích hoạt theo giờ chạy tiếp.
- Gọi API là gửi nội dung hàng tới hãng AI; Gemini API yêu cầu từ 18 tuổi, và đừng gửi dữ liệu cá nhân của người khác.
Code Python trong bài chỉ dùng thư viện chuẩn. Đoạn Apps Script là khung mẫu: địa chỉ API và cấu trúc yêu cầu phải lấy từ tài liệu của hãng bạn dùng. Thời gian mỗi lần gọi trong ví dụ là giả lập.
Apps Script là gì
Apps Script là JavaScript chạy trên máy chủ của Google, gắn với Sheets, Docs, Gmail và các dịch vụ khác. Trong một bảng tính, bạn mở trình soạn thảo script, viết hàm đọc và ghi ô, rồi chạy. Không cần cài gì, không cần máy chủ. Để gọi mô hình AI, script dùng dịch vụ UrlFetchApp gửi yêu cầu HTTP tới API của hãng, như Gemini API mà bài Google AI Studio là gì đã hướng dẫn lấy khóa.
Cất khóa API đúng chỗ
Tài liệu Properties Service mô tả ba loại kho: thuộc tính của script, dùng chung cho mọi người dùng script; thuộc tính của người dùng; thuộc tính của tài liệu. Tài liệu lấy ví dụ thuộc tính của script hợp để lưu cấu hình chung của ứng dụng, và cho thêm tối đa 50 thuộc tính bằng tay trong trang cài đặt dự án, mục Script Properties.
Cất khóa API ở đó, rồi trong code đọc bằng PropertiesService.getScriptProperties().getProperty("KHOA_API"). Cách này giữ khóa khỏi mã nguồn, nên khi bạn chép code cho người khác xem, khóa không đi theo. Vì thuộc tính của script dùng chung cho mọi người dùng script, chỉ chia sẻ quyền sửa dự án cho người tin cậy. Bài giữ khóa API an toàn có thêm nguyên tắc.
Khung code Apps Script
Đoạn dưới đây là khung: đọc các hàng, bỏ qua hàng đã có kết quả, gọi API cho từng hàng, ghi kết quả và dừng trước khi hết 6 phút. Phần DIA_CHI_API và taoYeuCau để trống có chủ ý: địa chỉ, tên mô hình, tên trường trong yêu cầu mỗi hãng một khác và đổi theo thời gian, hãy chép từ tài liệu API của hãng bạn dùng.
const DIA_CHI_API = "..."; // lấy từ tài liệu API của hãng
const COT_VAO = 1, COT_RA = 2; // cột A: nội dung, cột B: kết quả
const GIOI_HAN_MS = 5 * 60 * 1000; // dừng sớm hơn 6 phút
function xuLyBang() {
const batDau = Date.now();
const khoa = PropertiesService.getScriptProperties().getProperty("KHOA_API");
const bang = SpreadsheetApp.getActiveSheet();
const duLieu = bang.getDataRange().getValues();
for (let i = 1; i < duLieu.length; i++) { // bỏ hàng tiêu đề
if (duLieu[i][COT_RA - 1] !== "") continue; // hàng đã xong
if (Date.now() - batDau > GIOI_HAN_MS) return; // để lần chạy sau làm tiếp
const traLoi = UrlFetchApp.fetch(DIA_CHI_API, {
method: "post",
contentType: "application/json",
headers: taoTieuDe(khoa), // theo tài liệu của hãng
payload: JSON.stringify(taoYeuCau(duLieu[i][COT_VAO - 1])),
});
bang.getRange(i + 1, COT_RA).setValue(docKetQua(traLoi.getContentText()));
}
}
Tài liệu UrlFetchApp mô tả các tùy chọn dùng ở trên: method là phương thức HTTP, headers là bảng tiêu đề, payload là thân yêu cầu, và ví dụ đặt contentType là JSON khi gửi đối tượng đã chuyển thành chuỗi.
Hạn mức: vì sao script dừng giữa chừng
Trang Quotas, cập nhật 3/9/2026, ghi hai cột cho tài khoản cá nhân và Google Workspace. Ba con số ảnh hưởng nhất tới việc gọi AI cho bảng tính:
- Thời gian mỗi lần chạy: 6 phút cho cả hai loại tài khoản. Quá 6 phút, script bị dừng.
- Tổng thời gian chạy bằng trình kích hoạt: 90 phút mỗi ngày với tài khoản cá nhân, 6 giờ với Workspace.
- Số lần gọi UrlFetch: 20.000 mỗi ngày với tài khoản cá nhân, 100.000 với Workspace.
Mỗi lần gọi API AI mất vài giây, nên 6 phút chỉ đủ vài chục tới vài trăm hàng. Bảng lớn hơn phải chia thành nhiều lần chạy, và đó là lý do khung code ở trên đánh dấu hàng đã xong và dừng sớm.
Tính trước số lần chạy
Đoạn Python dưới đây nhận số hàng và thời gian một lần gọi API (bạn đo trên vài hàng thử), rồi tính mỗi lần chạy xử lý được bao nhiêu hàng nếu chỉ dùng 80% của 6 phút, cần bao nhiêu lần chạy, và ít nhất bao nhiêu ngày theo hạn mức 90 phút và 20.000 lần gọi mỗi ngày.
"""Bảng tính có N hàng, mỗi hàng gọi API AI một lần từ Apps Script: chạy được không, mất mấy lần chạy?
Hạn mức Apps Script (trang Quotas, cập nhật 3/9/2026), cột tài khoản cá nhân / Google Workspace:
- mỗi lần chạy script tối đa 6 phút
- tổng thời gian chạy bằng trình kích hoạt: 90 phút/ngày / 6 giờ/ngày
- số lần gọi UrlFetch: 20.000/ngày / 100.000/ngày
Thời gian một lần gọi API trong ví dụ là GIẢ LẬP: đo trên bảng của bạn rồi thay vào.
Chỉ dùng thư viện chuẩn.
"""
import math
HAN_MUC = {
"ca_nhan": {"giay_moi_lan": 6 * 60, "giay_kich_hoat_ngay": 90 * 60, "fetch_ngay": 20_000},
"workspace": {"giay_moi_lan": 6 * 60, "giay_kich_hoat_ngay": 6 * 3600, "fetch_ngay": 100_000},
}
def ke_hoach(so_hang, giay_moi_goi, loai="ca_nhan", du_phong=0.8):
"""Trả về (hàng mỗi lần chạy, số lần chạy, số ngày tối thiểu).
du_phong: chỉ dùng 80% của 6 phút để còn thời gian ghi kết quả, tránh bị cắt ngang.
Chia rồi làm tròn xuống (cộng 1e-9 để 288 / 0,1 không thành 2.879 vì sai số số thực).
"""
h = HAN_MUC[loai]
hang_moi_lan = max(1, math.floor(h["giay_moi_lan"] * du_phong / giay_moi_goi + 1e-9))
so_lan = math.ceil(so_hang / hang_moi_lan)
# mỗi ngày bị chặn bởi tổng thời gian kích hoạt và số lần UrlFetch
hang_ngay_theo_gio = math.floor(h["giay_kich_hoat_ngay"] / giay_moi_goi + 1e-9)
hang_ngay = min(hang_ngay_theo_gio, h["fetch_ngay"])
so_ngay = math.ceil(so_hang / hang_ngay)
return hang_moi_lan, so_lan, so_ngay
if __name__ == "__main__":
for so_hang, giay in ((300, 3), (5000, 3), (5000, 1.5)):
hm, lan, ngay = ke_hoach(so_hang, giay)
print(f"{so_hang} hàng, {giay} giây/lần gọi (tài khoản cá nhân): "
f"{hm} hàng mỗi lần chạy, {lan} lần chạy, ít nhất {ngay} ngày")
Với 3 giây mỗi lần gọi, mỗi lần chạy xử lý 96 hàng. Bảng 300 hàng cần 4 lần chạy, xong trong một ngày. Bảng 5.000 hàng cần 53 lần chạy và ít nhất 3 ngày, vì 90 phút mỗi ngày chỉ đủ cho 1.800 lần gọi 3 giây. Nếu mỗi lần gọi chỉ 1,5 giây, 5.000 hàng cần 27 lần chạy và 2 ngày. Phần kiểm đi kèm so mọi con số với phép tính tay. Code cộng một sai số rất nhỏ trước khi làm tròn xuống, vì với số thực, 288 chia 0,1 cho kết quả nhỏ hơn 2.880 một chút và làm tròn xuống thành 2.879.
Chạy tiếp tự động bằng trình kích hoạt
Tài liệu về trình kích hoạt cài đặt mô tả trình kích hoạt theo thời gian, giống cron trên Unix, cho script chạy vào giờ cố định hay theo chu kỳ, dày nhất mỗi phút, thưa nhất mỗi tháng. Với bảng lớn, đặt hàm xuLyBang chạy mỗi giờ; mỗi lần nó làm tiếp các hàng còn trống, tới khi xong thì các lần sau không còn gì để làm. Nhớ rằng tổng thời gian chạy bằng trình kích hoạt bị giới hạn mỗi ngày.
Hàm tùy chỉnh hay script chạy riêng
Nhiều hướng dẫn viết một hàm tùy chỉnh, kiểu gõ công thức vào ô để gọi AI cho ô đó. Cách này tiện để thử, nhưng trang Quotas ghi thời gian chạy của hàm tùy chỉnh chỉ 30 giây mỗi lần, và bảng tính có thể tính lại công thức nhiều lần, mỗi lần lại gọi API và tốn tiền. Với việc xử lý cả cột, script chạy riêng như khung ở trên dễ kiểm soát hơn: chạy khi bạn muốn, ghi kết quả thành giá trị cố định, không tự gọi lại.
Thử nhỏ trước khi chạy cả bảng
Trước khi chạy cho vài nghìn hàng, sao năm hàng sang một trang tính thử. Chạy script, xem kết quả có đúng dạng bạn cần không, như một nhãn trong danh sách cho trước hay một câu tóm tắt dưới 30 chữ. Ghi lại mỗi lần gọi mất bao nhiêu giây để đưa vào đoạn Python tính số lần chạy. Kiểm tra cả trang quản lý khóa của hãng AI để biết năm lần gọi tốn bao nhiêu, rồi nhân lên cho cả bảng.
Ghi lỗi thay vì dừng
Khi gọi API cho hàng trăm hàng, sẽ có lần lỗi: mạng chập chờn, hãng giới hạn số lần gọi mỗi phút, nội dung một hàng quá dài. Nếu script dừng ở lỗi đầu tiên, các hàng sau phải chờ lần chạy tới. Cách gọn là bọc phần gọi API trong khối try và catch, khi lỗi thì ghi chữ "LỖI" kèm mã lỗi vào một cột riêng rồi đi tiếp. Cuối ngày, lọc các hàng có chữ LỖI để xem lại, xóa đánh dấu và để lần chạy sau thử lại.
Dữ liệu và độ tuổi
Mỗi hàng gửi đi là nội dung tới máy chủ của hãng AI, theo điều khoản của hãng. Bài Google AI Studio đã đọc điều khoản Gemini API: người dùng phải từ 18 tuổi. Trước khi gửi, bỏ những cột không cần, như họ tên, số điện thoại, email; chỉ gửi cột nội dung cần AI xử lý. Với việc phân loại, bài phân loại văn bản bằng LLM có cách viết nhãn và đo độ chính xác trước khi chạy cho cả bảng.
- Viết khóa API thẳng trong code rồi chia sẻ bảng tính hay dự án.
- Chạy một lần cho cả bảng lớn, để script bị cắt ở phút thứ 6 giữa chừng.
- Không đánh dấu hàng đã xong, khiến lần chạy sau gọi API lại từ đầu và tốn tiền gấp đôi.
- Gửi cả cột họ tên, số điện thoại tới API.
- Đặt trình kích hoạt chạy mỗi phút cho việc chỉ cần chạy mỗi giờ.
Câu hỏi thường gặp
Apps Script có gọi được ChatGPT, Gemini, Claude không?
Được, bằng UrlFetchApp gửi yêu cầu tới API của hãng theo tài liệu của hãng đó.
Cất khóa API trong Apps Script ở đâu?
Trong Script Properties ở trang cài đặt dự án, rồi đọc bằng PropertiesService.
Vì sao script dừng sau 6 phút?
Hạn mức Apps Script cho mỗi lần chạy tối đa 6 phút; chia bảng thành nhiều lần chạy.
Một ngày gọi API được bao nhiêu lần?
Tài khoản cá nhân 20.000 lần UrlFetch mỗi ngày, Google Workspace 100.000 lần.
Học tiếp
Nếu bạn muốn học Python và AI bài bản cùng giảng viên, tham khảo khóa học AI của Big-O Coding.
Khóa AI – Introduction to Machine Learning: nền tảng Máy học từ thuật toán cơ bản đến Neural Networks và LLM, học bằng Python. Học thử buổi 1 miễn phí.


