Google Sheets
Bảng tính phổ biến cho dữ liệu thủ công, danh mục bổ sung và mapping bảng.
Loại API
REST API
Xác thực
Service Account
Tần suất refresh khả thi
Real-time, Mỗi giờ, Hằng ngày
Setup · Maintain hằng tháng
2-4 giờ · 1-2 giờ (chủ yếu xử lý lỗi user nhập sai)
Hướng dẫn kết nối, 6 bước
Làm theo thứ tự từ trên xuống. Mỗi bước có ngữ cảnh để đội kỹ thuật của bạn hiểu lý do, không phải checklist bấm.
- 1
Tạo Google Cloud project và Service Account
Tương tự GA4: tạo project, service account, JSON key trong console.cloud.google.com.
- 2
Enable Google Sheets API
APIs & Services > Library > tìm 'Google Sheets API' > Enable.
- 3
Share sheet với service account
Mở sheet > Share > paste email service account > role Viewer (đọc) hoặc Editor (đọc và ghi).
- 4
Lấy spreadsheetId từ URL
URL có dạng docs.google.com/spreadsheets/d/{spreadsheetId}/edit, copy phần {spreadsheetId}.
- 5
Kết nối qua googleapis
Cài googleapis (Python/Node). spreadsheets.values.get(spreadsheetId, range='Sheet1!A1:Z') để đọc.
- 6
Định nghĩa schema và validate khi ingest
Sheets cho phép user gõ tự do, pipeline phải validate column headers và data types. Reject row nếu không match schema, log để báo lại admin.
Credentials cần có
Lưu vào vault hoặc secret manager. Không hardcode trong code, không commit lên git.
Service Account JSON KeySpreadsheet ID
Trường dữ liệu mẫu
Các field thường có trong API response. Map vào schema warehouse khi ingest.
- Các cột do người dùng định nghĩa
Lỗi và pitfalls thường gặp tại Việt Nam
Đọc kỹ trước khi cam kết timeline, vài rủi ro dưới đây có thể kéo dài tích hợp thêm 1-2 tuần nếu không lên kế hoạch.
- User chỉnh sheet tự do (thêm cột, đổi tên, gõ sai format), pipeline phải validate chặt và alert khi sai schema.
- Date format trong sheet không đồng nhất (mm/dd/yyyy vs dd/mm/yyyy vs Excel serial), parse bằng try-except.
- Empty rows ở giữa sheet làm vỡ pipeline đọc tuần tự, skip thay vì abort.
- Quota: 100 request / 100 giây / user, không pull quá nhiều sheet đồng thời.
- Sheet > 5 triệu cells sẽ chậm và đôi khi timeout, chuyển sang BigQuery khi đạt ngưỡng đó.
Dashboard sử dụng Google Sheets
Xem toàn bộ thư viện dashboard →Công nợ quá hạn theo tuổi nợ
Phân bổ công nợ theo các nhóm tuổi nợ (0-30 / 31-60 / 61-90 / >90 ngày) theo từng khách hàng. Highlight khách đang trượt sang nhóm cao hơn để gọi điện trước khi quá trễ.
Mở dashboardHiệu quả nhân viên kinh doanh
Doanh thu, biên gộp, công nợ quá hạn, số khách phụ trách, số đơn mỗi tháng, theo từng nhân viên kinh doanh. So sánh ngang giữa các nhân viên và xu hướng theo thời gian.
Mở dashboardDự báo dòng tiền 13 tuần
Tiền mặt cộng công nợ thu trong 13 tuần tới, trừ đi các khoản phải trả nhà cung cấp, lương và chi phí cố định. Cảnh báo các tuần có thể âm tiền trước khi đến để xoay hạn mức kịp.
Mở dashboardFood cost % theo món và chi nhánh
Tỷ lệ chi phí nguyên liệu trên doanh thu cho từng món và từng chi nhánh, so sánh với chuẩn công thức (theoretical food cost). Phát hiện món bị thâm hụt nguyên liệu vượt chuẩn, cảnh báo thất thoát hoặc khẩu phần lệch.
Mở dashboardKết nối Google Sheets vào data warehouse của doanh nghiệp bạn
Đặt lịch rà soát 30 phút. Chia sẻ tài khoản hiện tại, chúng tôi đề xuất phạm vi kết nối ưu tiên và timeline ngày bàn giao.