Google Sheets¶

Đang trong giai đoạn thử nghiệm

Bạn đang muốn ghi báo cáo vào Google Sheets?

Đây là hai việc khác nhau. Trang này nói về việc đọc một sheet như một nguồn dữ liệu qua API gateway. Để đẩy báo cáo Logidata vào Google Sheets, xem công thức Google Sheets — chạy bằng Apps Script, không cần kết nối này.

Base URL:

https://api.logidata.vn/v1/google-sheets/spreadsheets/{spreadsheet_id}/values/{range}

Đường dẫn, tham số và response giống hệt Sheets API — spreadsheets.values.get. Gốc là https://sheets.googleapis.com/v4.

Một kết nối = một tài khoản Google. spreadsheet_id và range là tham số của từng request.

Nhóm dữ liệu¶

Allowlist chỉ đọc, đúng một endpoint:

Method	Đường dẫn gốc	Dùng để
`GET`	`/spreadsheets/{spreadsheet_id}/values/{range}`	Đọc dữ liệu thô từ một sheet bạn chỉ định, trả về mảng hàng/cột

spreadsheet_id lấy từ URL của Google Sheet: docs.google.com/spreadsheets/d/<spreadsheet_id>/edit.
range theo ký hiệu A1, ví dụ Sheet1!A1:D100.

Dùng để làm gì¶

Ghép dữ liệu nền tảng với một bảng tra do bạn tự quản trong Google Sheet: danh sách SKU và giá vốn, ngân sách theo tháng, ánh xạ campaign → sản phẩm. Kéo sheet đó qua gateway rồi join với dữ liệu quảng cáo/đơn hàng trong pipeline — không cần export tay mỗi lần bảng thay đổi.

Đường ghi (tạo file báo cáo mới, cập nhật sheet có sẵn) nằm ngoài phạm vi kết nối này và sẽ được bổ sung sau. Hiện tại để ghi báo cáo ra Sheets, dùng Apps Script.

Xác thực và mã lỗi¶

X-API-Key + X-Account-Id (trỏ tới một tài khoản Google) như mọi nền tảng khác. Xem Xác thực và Mã lỗi.

HTTP	`code`	Nghĩa
401	`token_revoked`	Tài khoản Google đã thu hồi quyền. Vào portal cấp lại quyền.