Hướng Dẫn Tạo Google API Key

Dành cho SRD Dashboard — Đọc dữ liệu từ Google Sheets

Thời gian thực hiện: ~10 phút

Bạn sẽ tạo một Google API Key để SRD Dashboard có thể đọc dữ liệu từ 3 Google Sheets: TongHopDomain, Nhansu và CheckTop.

Tổng Quan — Tại Sao Cần API Key?

Google Sheets

3 file nguồn dữ liệu

Google API Key

xác thực quyền đọc

SRD Dashboard

Hiển thị báo cáo

Google API Key (Đơn giản)

Tạo miễn phí, không cần credit card
Chỉ cần quyền đọc (read-only)
Phù hợp cho internal tool
Giới hạn 300 request/phút (đủ dùng)

Lưu ý quan trọng

Không share API Key công khai
Sheets phải được share "Anyone with link"
Hoặc dùng chế độ Restricted + share riêng
Nên giới hạn IP hoặc Referrer

1Tạo Google Cloud Project

Truy cập Google Cloud Console

Mở trình duyệt và truy cập:

https://console.cloud.google.com/

Đăng nhập bằng Google Account của bạn (nên dùng account công ty)

Tạo Project mới

Click vào dropdown Project ở thanh trên cùng

Ở góc trái, cạnh logo Google Cloud, click vào tên project hiện tại (hoặc "Select a project")

Click NEW PROJECT ở góc trên phải popup

Nhập tên Project

Project name: SRD-SEO-Dashboard

Click CREATE và chờ khoảng 30 giây

console.cloud.google.com

My Project

Select a project ★ NEW PROJECT

Project name

SRD-SEO-Dashboard

CANCEL CREATE

2Bật Google Sheets API

Điều hướng tới API Library

Sau khi tạo project, truy cập đường dẫn sau (thay PROJECT_ID bằng ID project của bạn):

https://console.cloud.google.com/apis/library

Hoặc: Menu trái → APIs & Services → Library

Tìm và bật Google Sheets API

Trong ô Search, gõ:

Google Sheets API

Click vào kết quả "Google Sheets API"

Click nút ENABLE

Chờ khoảng 30 giây để API được bật

Google Sheets API

Google Enterprise API

ENABLE

Reads and writes Google Sheets.

Sau khi bật thành công, trang sẽ chuyển sang màn hình API Overview với trạng thái ENABLED

3Tạo API Key

Vào phần Credentials

Từ menu bên trái, chọn:

APIs & Services → Credentials

Tạo Credentials mới

Click + CREATE CREDENTIALS ở trên cùng

Chọn "API key" từ dropdown

API key

OAuth client ID

Service account

API Key sẽ được tạo và hiện ra popup

✅ API key created

Use this key in your application by passing it with the key=API_KEY parameter.

AIzaSyXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

⚠ Copy API key này ngay vì sau khi đóng sẽ không thấy lại đầy đủ

Click icon copy để copy API Key

Dán vào Notepad/Notes để lưu tạm. API key có dạng: AIzaSy...

4Giới Hạn API Key (Khuyến Nghị)

Bước này không bắt buộc nhưng rất nên làm để bảo mật API Key khỏi bị lạm dụng.

Giới hạn chỉ cho Google Sheets API

Sau khi tạo key, click "Edit API key" hoặc click vào tên key trong danh sách

Trong phần "API restrictions", chọn "Restrict key"

Trong dropdown chọn APIs, tìm và tick:

Google Sheets API

Google Drive API (không cần thiết)

Click SAVE

5Share 3 Google Sheets Cho API Key Đọc Được

Bắt buộc! Nếu Sheet ở chế độ Private, API Key sẽ không đọc được dữ liệu dù đã tạo đúng.

Có 2 phương án share:

Khuyến nghị

Phương án A: Anyone with link

Đơn giản nhất, phù hợp nếu data không quá nhạy cảm

1. Mở Google Sheet
2. Click nút "Share" góc trên phải
3. Click "Change to anyone with the link"
4. Chọn quyền "Viewer" (chỉ đọc)
5. Click "Done"

Bảo mật hơn

Phương án B: Giữ Private

Phù hợp nếu dữ liệu nhạy cảm, cần kiểm soát chặt

1. Tạo Service Account thay vì API Key
2. Copy email của Service Account
3. Share Sheet → Add people → Paste email SA
4. Chọn quyền "Viewer"
5. Xem hướng dẫn Service Account riêng

Share cả 3 Google Sheets sau:

1-TongHopDomain

https://docs.google.com/spreadsheets/d/1EVJGC_S-Gz3N2me0GHb7xLeq2z08W-iP_lSYSVscvmE/edit

2-Nhansu

https://docs.google.com/spreadsheets/d/1h2nB1DFKeYyFF4qixfQp3ajUwKEXXe7pOMXUugqR4Ws/edit

5-CheckTop

https://docs.google.com/spreadsheets/d/1sVXBGiTyvFD9ixgtEspixDcpX_iPQt1Ji5G3eAQPsxo/edit

6Nhập API Key vào SRD Dashboard

Các bước nhập trong SRD

Đăng nhập vào SRD Dashboard với tài khoản Super Admin

Username: admin | Password: Admin@SRD2025

Vào ⚙️ Cài Đặt ở menu trái (chỉ Super Admin thấy)

Trong phần Google Sheets Config, điền vào ô "Google API Key"

Google Sheets Config

Google API Key

AIzaSyXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Sheet ID - TongHopDomain

1EVJGC_S-Gz3N2me0GHb7xLeq2z08W-iP_lSYSVscvmE

Kiểm tra 3 Sheet IDs đã được điền sẵn (đúng theo SRD brief)

Click 💾 Lưu Cài Đặt

Vào 🔄 Sync Engine → Click "Sync All Data"

Nếu sync thành công, bạn sẽ thấy số records được cập nhật trong Sync Logs!

Xử Lý Lỗi Thường Gặp

Lỗi 403 API key not valid. Please pass a valid API key.

Nguyên nhân: API Key sai hoặc chưa bật Google Sheets API

Kiểm tra lại API Key đã copy đúng chưa (không thừa dấu cách)
Đảm bảo đã bật Google Sheets API ở Bước 2
Đảm bảo API Key thuộc đúng Project đã bật Sheets API

Lỗi 403 The caller does not have permission

Nguyên nhân: Google Sheet chưa được share

Mở từng Sheet và thực hiện lại Bước 5
Đảm bảo chọn "Anyone with the link" + quyền Viewer

Lỗi 400 Unable to parse range

Nguyên nhân: Sheet ID sai hoặc tên sheet tab không đúng

Kiểm tra Sheet ID trong URL: /spreadsheets/d/SHEET_ID/
File TongHopDomain phải có sheet tab tên DM
File CheckTop phải có 2 sheet: Brand-11-30 và Full-1-10

Sync OK Sync thành công nhưng dữ liệu = 0

Nguyên nhân: Cấu trúc cột không khớp

Đảm bảo Sheet TongHopDomain có sheet tab đúng tên DM (không phải Sheet1)
Row đầu tiên phải là header, dữ liệu bắt đầu từ row 2
Cột A phải có domain_name (file TongHopDomain)
Cột C phải có Internal Name (file Nhansu)

FAQ - Câu Hỏi Thường Gặp

Google API Key có mất phí không?

Hoàn toàn miễn phí trong giới hạn free tier. Google Sheets API cho phép 300 read requests/minute và 60 requests/user/minute. SRD chỉ sync mỗi 5 phút nên hoàn toàn nằm trong giới hạn miễn phí.

Cần bao nhiêu Google Account?

Chỉ cần 1 Google Account để tạo API Key. Account đó không nhất thiết phải là chủ sở hữu của 3 Sheets — chỉ cần Sheets được share "Anyone with link" là đủ.

API Key có thể đọc được Sheet của người khác không?

Có, miễn là Sheet đó được share "Anyone with the link" (Viewer). API Key chỉ cần để xác thực request — không cần phải là chủ Sheet.

Nếu Sheet ID thay đổi thì phải làm gì?

Vào SRD Settings → cập nhật lại Sheet ID mới → Lưu → Sync lại. Sheet ID nằm trong URL của Google Sheets: .../spreadsheets/d/SHEET_ID_HERE/edit

Nếu lỡ lộ API Key thì phải làm gì?

Vào Google Cloud Console → Credentials → Xóa key cũ → Tạo key mới → Cập nhật vào SRD Settings. Toàn bộ quy trình mất khoảng 2 phút.

Sẵn sàng bắt đầu!

Sau khi hoàn thành 6 bước trên, SRD Dashboard sẽ tự động đồng bộ dữ liệu từ Google Sheets mỗi 5 phút.

Đăng Nhập SRD Mở Google Cloud Console