Minh Quân GreenMinh Quân Green
Thư viện kết nối

Kết nối Google Sheets — 3 cách

Cho Agent ghi dữ liệu vào bảng tính Google của bạn. Chọn cách đang có chấm ● xanh — cách đó dùng được ngay.

Cập nhật 22/9/2026 Đã làm lại và kiểm chứng ngày 22/9/2026

1. Agent làm được gì

Agent ghi thêm dòng vào bảng tính Google của bạn (vd lưu khách vừa hỏi giá: tên · số điện thoại · ghi chú) và đọc dữ liệu bảng tính (vd bảng giá) để trả lời khách.

2. Cần chuẩn bị

  • Tài khoản Google và một bảng tính muốn dùng.
  • Khoảng 5 phút (cách 1) hoặc khoảng 3 phút làm thêm (cách 3 — Apps Script) · độ khó: dễ.

3. Cách kết nối

  • Chọn bảng tính của bạn
  • Mọi bảng tính trong Drive
  • Apps Script (nâng cao)

4. Lấy khóa — từng bước

Mở đúng chỗ

  1. Vào Xưởng → mở Agent cần dùng (hoặc bấm Tạo Agent).
  2. Chọn tab Công cụ → mục Ứng dụng có sẵn → bấm thẻ Google Sheets.
  3. Bạn thấy 3 cách kết nối. Cách có chấm ● xanh là cách dùng được ngay; cách có ○ là tạm chưa dùng được. Nền tảng tự mở sẵn cách dùng được.
CáchHợp vớiBạn phải làm
Chọn bảng tính của bạnhầu hết mọi người — khuyên dùngĐăng nhập Google, chọn bảng tính
Mọi bảng tính trong Drivekhi cần Agent ghi vào nhiều bảng tínhĐăng nhập Google, dán mã bảng tính
Apps Script (nâng cao)dùng được ngay hôm nayDán một đoạn mã vào bảng tính (khoảng 3 phút)

Cách 1 — Chọn bảng tính của bạn (khuyên dùng)

  1. Bấm Kết nối Google (1 chạm). Một cửa sổ nhỏ mở ra — trang bạn đang làm không bị rời đi.
  2. Chọn tài khoản Google của bạn → bấm Cho phép. Quyền xin là loại hẹp nhất: Agent chỉ đụng tới bảng tính bạn tự chọn.
  3. Bấm Chọn bảng tính từ Google Drive → chọn bảng tính muốn dùng.
  4. Chọn Trang tính (ví dụ “Trang tính1”).
  5. Bấm Thêm ở việc cần làm:
  • Ghi thêm 1 dòng — Agent thêm dòng mới vào cuối trang (cột A, B, C).
  • Đọc dữ liệu bảng tính — Agent đọc tối đa 200 dòng đầu (ví dụ bảng giá).
  1. Bấm Lưu nháp ở góc trên → thử ở khung Chạy thử (xem mục Kiểm tra bên dưới).
Lưu ý: nếu thẻ ghi “Nền tảng đang bật — tạm chưa dùng được”, hãy dùng Cách 3 trong lúc chờ.

Cách 2 — Mọi bảng tính trong Drive

Cách này cần Google xác minh ứng dụng của nền tảng. Khi thẻ còn ghi “Chờ Google xác minh — tạm chưa dùng được”, hãy dùng Cách 1 hoặc Cách 3.

Khi cách này đã mở:

  1. Bấm Kết nối bằng Google (1 chạm) → chọn tài khoản → Cho phép.
  2. Mở bảng tính trên trình duyệt. Mã bảng tính là đoạn nằm giữa /d/ và /edit trên thanh địa chỉ. Dán vào ô Spreadsheet ID.
  3. Ô Vùng ghi: tên trang + ô bắt đầu, ví dụ Trang tính1!A1.
  4. Bấm Thêm ở Ghi 1 dòng dữ liệu → Lưu nháp.

Cách 3 — Apps Script (dùng được ngay)

Phần A — làm một lần trong bảng tính của bạn:

  1. Mở bảng tính Google muốn ghi → menu Tiện ích mở rộng (Extensions) → Apps Script.
  2. Xóa hết mã có sẵn, dán đoạn mã dưới đây vào, bấm biểu tượng Lưu.
Mã Apps Script — dán vào bước 2
function doPost(e) {
  var trang = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  var d = JSON.parse((e && e.postData && e.postData.contents) || "{}");
  trang.appendRow([d.a || "", d.b || "", d.c || ""]);
  return ContentService.createTextOutput(JSON.stringify({ ok: true }))
    .setMimeType(ContentService.MimeType.JSON);
}
  1. Bấm Triển khai (Deploy) → Tùy chọn triển khai mới (New deployment) → biểu tượng bánh răng → chọn Ứng dụng web (Web app).
  2. Thực thi dưới dạng (Execute as): Tôi. Người có quyền truy cập (Who has access): Bất kỳ ai (Anyone) → bấm Triển khai.
  3. Google hỏi cấp quyền → chọn tài khoản của bạn. Nếu thấy màn hình “Google chưa xác minh ứng dụng này”: đó là đoạn mã của chính bạn — bấm Nâng cao → Đi tới … (không an toàn) → Cho phép.
  4. Sao chép URL ứng dụng web (kết thúc bằng /exec).

Phần B — trên nền tảng:

  1. Ở thẻ Google Sheets, chọn cách Nâng cao: Apps Script.
  2. Dán URL vào ô URL ứng dụng Apps Script → bấm Lưu kết nối.
  3. Ở Bước 2, bấm Thêm tại Ghi 1 dòng dữ liệu → Lưu nháp.
Giữ kín đường link /exec như mật khẩu: ai có link đều ghi được vào bảng tính của bạn. Nút Kiểm tra kết nối sẽ báo chưa kiểm tra tự động được — đó là bình thường với cách này; hãy kiểm bằng cách chạy thử ở dưới.

5. Dán vào Minh Quân Green

Không phải dán gì: bấm nút kết nối, đăng nhập và cấp quyền.

6. Kiểm tra

  1. Ở khung Chạy thử bên phải trình dựng, gõ: “Ghi vào bảng tính: Nguyễn Văn A, 0909 000 000, khách hỏi giá”.
  2. Mở bảng tính: trang đầu tiên có thêm một dòng mới (cột A, B, C).
  3. Được rồi thì bấm Xuất bản để khách thật dùng Agent.

7. Quyền & bảo mật

Minh Quân Green không nhận mật khẩu của bạn. Bạn thu hồi quyền bất cứ lúc nào trong trang quản lý tài khoản của nhà cung cấp.

8. Giới hạn & chi phí

Hạn mức theo tài khoản Google Sheets của bạn.

9. Lỗi thường gặp

Dấu hiệuCách xử lý
Cách 3: không có dòng nàoKiểm lại bước 4: Người có quyền truy cập phải là Bất kỳ ai
Cách 3: sửa mã xong vẫn như cũMỗi lần sửa mã phải Triển khai → Quản lý các lần triển khai → Phiên bản mới; nếu tạo triển khai MỚI thì URL đổi — dán lại URL mới
Dòng ghi vào sai trangMã ghi vào trang đầu tiên — kéo trang cần ghi lên đầu
Cách 1: báo Google chưa cho quyền lên bảng tínhBấm Chọn bảng tính khác và chọn lại đúng bảng tính qua hộp thoại
Báo “Kết nối đó do người khác tạo”Chỉ người tạo kết nối hoặc Quản trị tổ chức được nối lại — nhờ họ, hoặc tự tạo kết nối mới

Vẫn chưa được? Bấm Chưa được ở cuối khung hướng dẫn và ghi bạn kẹt ở bước nào — nhân viên sẽ sửa bài theo góp ý của bạn.