Lấy dữ liệu vào Google Sheets
Kéo giá vàng Việt Nam thẳng vào bảng tính Google Sheets bằng một công thức duy nhất — không cần biết lập trình. Dữ liệu tự cập nhật mỗi khi bạn mở lại file.
Bạn sẽ làm được gì
Sau hướng dẫn này, ô bảng tính của bạn sẽ tự động hiển thị bảng giá vàng theo ngày (ngày · giá mua · giá bán), kéo trực tiếp từ máy chủ Viet Dataverse.
Bước 1 — Lấy API token
API token (còn gọi là API key) là chuỗi ký tự dùng để xác nhận bạn có quyền lấy dữ liệu.
- và _), ví dụ:
Ab3xY7zK-mN0pQ2rS4tU6vW8xZ_1aB3cD5eF7gH9iJBước 2 — Viết công thức trong Google Sheets
B1 một lần duy nhất. Cách này giúp bạn không phải gõ lại token
ở mỗi công thức — mọi công thức sẽ tham chiếu tới ô B1. (Ô A1 ghi nhãn "api_key" cho dễ nhớ.)
&$B$1, không cần gõ token:
=VDV_GOLD("SJC","1m") (token nhập 1 lần qua menu)? Xem
Kết nối nhanh bằng Apps Script — đánh đổi là phải bấm qua một cảnh báo của Google 1 lần.
date buy_price sell_price
2026-05-16 11850000 12050000
2026-05-17 11870000 12070000
...IMPORTDATA của Google không gửi được
"header" như khi lập trình, nên Viet Dataverse cho phép truyền token qua tham số api_key= ngay trên URL.
Bước 3 — Đổi loại vàng & khoảng thời gian
Bạn chỉ cần sửa 2 phần trong đường link: type (loại vàng) và period (khoảng thời gian).
| Tham số | Giá trị | Ý nghĩa |
|---|---|---|
type | SJC | Vàng miếng SJC |
DOJI HN | DOJI Hà Nội | |
PNJ | Vàng PNJ | |
BTMC | Bảo Tín Minh Châu | |
period | 7d | 7 ngày gần nhất |
1m | 1 tháng gần nhất | |
1y | 1 năm gần nhất | |
all | Toàn bộ lịch sử |
Ví dụ — lấy giá vàng DOJI Hà Nội trong 1 năm (token vẫn lấy từ ô B1, không gõ lại):
type/period — phần &$B$1 giữ nguyên ở mọi ô.
Đổi key sau này chỉ cần sửa ô B1, tất cả công thức tự cập nhật.
Không chỉ có vàng — các bộ dữ liệu khác
Viet Dataverse cung cấp toàn bộ dữ liệu có trên trang chủ. Đầy đủ các bộ dữ liệu & endpoint:
| Bộ dữ liệu | Endpoint | Tham số chính |
|---|---|---|
| Giá vàng | /api/v1/gold | type (SJC·DOJI HN·PNJ·BTMC), period |
| Giá bạc | /api/v1/silver | period |
| Tỷ giá ngoại tệ (VCB) | /api/v1/sbv-rate | bank=VCB, currency (USD·EUR·JPY…), period |
| Lãi suất liên ngân hàng (SBV) | /api/v1/sbv-interbank | period |
| Lãi suất tiết kiệm | /api/v1/termdepo | period |
| CPI / Lạm phát | /api/v1/macro/cpi | period |
| Dữ liệu toàn cầu (vàng·bạc·Nasdaq) | /api/v1/global-macro | period |
IMPORTDATA chỉ đọc được CSV, hiện có sẵn cho giá vàng.
Các bộ còn lại (bạc, tỷ giá, lãi suất, CPI…) dùng được ngay trong Excel qua Power Query
(xem hướng dẫn Excel) hoặc qua API.
Chúng tôi đang bổ sung CSV để IMPORTDATA dùng được cho mọi bộ dữ liệu.
Bước 4 — Cập nhật dữ liệu
Google Sheets tự động làm mới dữ liệu IMPORTDATA khoảng mỗi giờ, và mỗi khi bạn mở lại file.
Muốn làm mới ngay lập tức:
- Xoá ô chứa công thức rồi dán lại công thức (cách nhanh nhất), hoặc
- Vào File → Cài đặt bảng tính (Settings) → Tính toán (Calculation) → đặt "Tính lại khi" thành "Khi thay đổi và mỗi phút".
Lỗi thường gặp
Ô hiện #ERROR! hoặc "Could not fetch url"
Thường do thiếu format=csv trong link, hoặc token sai. Kiểm tra: đường link phải có đủ &format=csv&api_key=... và token còn hiệu lực.
Ô hiện một dòng chữ {"success": false ... 401}
Token không hợp lệ hoặc đã bị thu hồi. Vào trang Developer để kiểm tra/tạo lại token.
Ô hiện lỗi liên quan đến 429 / hết quota
Bạn đã dùng hết lượt gọi trong tháng. Chờ sang đầu tháng (quota reset ngày 1).
Dữ liệu không tự cập nhật
Đây là cơ chế của Google (làm mới mỗi ~1 giờ). Xem lại Bước 4 để làm mới thủ công.
Cần hỗ trợ? Email findatasolution@gmail.com hoặc xem thêm API Reference.