Quay lại catalog nguồn dữ liệu
Bảng tínhPhù hợp với RetailerPhù hợp với DistributorPhù hợp với F&B

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. 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. 2

    Enable Google Sheets API

    APIs & Services > Library > tìm 'Google Sheets API' > Enable.

  3. 3

    Share sheet với service account

    Mở sheet > Share > paste email service account > role Viewer (đọc) hoặc Editor (đọc và ghi).

  4. 4

    Lấy spreadsheetId từ URL

    URL có dạng docs.google.com/spreadsheets/d/{spreadsheetId}/edit, copy phần {spreadsheetId}.

  5. 5

    Kết nối qua googleapis

    Cài googleapis (Python/Node). spreadsheets.values.get(spreadsheetId, range='Sheet1!A1:Z') để đọc.

  6. 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 Key
  • Spreadsheet 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 đó.
Bước tiếp theo

Kế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.