# Hướng dẫn cài đặt Học từ vựng tiếng Trung PRO

Cài Apps Script cho Học từ vựng tiếng Trung PRO trong khoảng 6 phút. Chỉ áp dụng cho bản Google Trang tính.

## Thông tin nhanh

- **Menu sau khi cài:** 🏮 Học tiếng Trung (hiện cạnh menu Trợ giúp)
- **Mục bấm đầu tiên:** Mở hộp thoại học — đây là lúc Google hỏi quyền
- **Số file phải dán:** 3 (Code.gs, Data, App)
- **Thời gian:** khoảng 6 phút, làm một lần
- **Web App:** không
- **Trang sản phẩm:** https://www.hitava.cloud/san-pham/hoc-tu-vung-tieng-trung-pro

## Các file trong thư mục 2-Apps-Script

- `Code.gs` (Tập lệnh): phần chạy trên máy chủ Google
- `Data` (Tập lệnh): bảng chữ Hán cho Tự điền (âm Hán Việt, bộ thủ, số nét, phồn thể) — thêm bằng Tệp › + › Tập lệnh, KHÔNG phải HTML
- `App` (HTML): hộp thoại học: Hôm nay, Ôn tập, Luyện tập & thanh điệu, Sổ từ, Thêm từ, Thống kê

## Các bước

1. Mở file bằng Google Trang tính (bản sao từ "Tài liệu của tôi" đã có sẵn script, bỏ qua bước 1–2).
2. Tệp › Cài đặt: Ngôn ngữ Việt Nam, Múi giờ (GMT+07:00) Bangkok, Hà Nội, Tính lại "Khi thay đổi và mỗi giờ".
3. Tiện ích mở rộng › Apps Script › dán Code.gs vào Mã.gs.
4. Thêm các file còn lại đúng tên: Data (Tập lệnh), App (HTML).
5. Lưu, quay lại bảng tính, nhấn F5. Menu 🏮 Học tiếng Trung hiện cạnh Trợ giúp.
6. Bấm 🏮 Học tiếng Trung › Mở hộp thoại học. Google hỏi quyền: Tiếp tục › chọn tài khoản › "Google chưa xác minh ứng dụng này" › Nâng cao › Chuyển đến … (không an toàn) › Cho phép.

Cảnh báo "chưa được xác minh" là bình thường với mọi Apps Script tự dán vào file của mình; Google chỉ xác minh ứng dụng nộp hồ sơ phát hành công khai.

## Quyền Google hỏi ở mẫu này

- **Xem, sửa, tạo, xoá bảng tính:** đọc và ghi vào chính file của bạn
- **Hiện và chạy nội dung bên thứ ba:** mở hộp thoại quản lý bên trong bảng tính

Dữ liệu nằm trong Google Drive của khách. Script chạy bằng tài khoản Google của khách, không gửi dữ liệu ra ngoài; HiTaVa không xem được file.

## Việc làm một lần

- Kiểm tra múi giờ — lịch ôn tập tính theo ngày, sai múi giờ là “hôm nay” lệch gần nửa ngày.
- Mở hộp thoại học › Hôm nay để bắt đầu; Thêm từ mới sẽ tự điền âm Hán Việt, bộ thủ, số nét từ file Data.

## Trên Excel

Trên Excel vẫn dùng được các tab, công thức, Ôn hôm nay và Flashcard trong bảng. Không có: hộp thoại học, tự điền chữ Hán, luyện thanh điệu, thống kê.

Trang HTML: https://www.hitava.cloud/huong-dan/hoc-tu-vung-tieng-trung-pro