# Hướng dẫn cài đặt Luyện thi TOEIC PRO

Cài Apps Script cho Luyện thi TOEIC PRO trong khoảng 8 phút. Chỉ áp dụng cho bản Google Trang tính.

## Thông tin nhanh

- **Menu sau khi cài:** 🎯 TOEIC (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, App, WebApp)
- **Thời gian:** khoảng 8 phút, làm một lần
- **Web App:** không
- **Trang sản phẩm:** https://www.hitava.cloud/san-pham/luyen-thi-toeic-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
- `App` (HTML): hộp thoại học trên máy tính: Hôm nay, Lộ trình, Luyện Part 5, Ôn tập, Sổ lỗi sai, Chấm phiếu, Thống kê
- `WebApp` (HTML, tuỳ chọn): bản học trên điện thoại — chỉ cần nếu bạn muốn ôn từ và luyện Part 5 lúc di chuyển

## 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: App (HTML), WebApp (HTML).
5. Lưu, quay lại bảng tính, nhấn F5. Menu 🎯 TOEIC hiện cạnh Trợ giúp.
6. Bấm 🎯 TOEIC › 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 và đếm ngược ngày thi tính theo ngày, sai múi giờ là “hôm nay” lệch gần nửa ngày.
- Mở tab Cài đặt, gõ Điểm mục tiêu và Ngày thi. Chưa đăng ký thi thì để trống Ngày thi, lộ trình chạy mặc định 12 tuần. Gõ ngày vào sau cũng được, cả lộ trình và lịch ôn tự tính lại mà không mất tiến độ.
- Muốn học trên điện thoại: Triển khai › Tùy chọn triển khai mới › Ứng dụng web, Thực thi bằng Tôi, rồi mở hộp thoại trên máy tính để bật Web App, đặt mã PIN 4–8 chữ số và lấy link riêng. Link và PIN là thứ bảo vệ dữ liệu của bạn — đừng chia sẻ. Sai PIN 5 lần sẽ khoá 15 phút.

## Trên Excel

Trên Excel vẫn dùng được mọi tab và công thức, kể cả Lộ trình, Phiếu chấm tự chấm và Flashcard trong bảng. Không có: hộp thoại học, Web App trên điện thoại, phát âm, luyện Part 5 tự chấm, email nhắc. Bạn ghi kết quả ôn bằng tay (gõ ngày Ôn gần nhất, chỉnh cột Hộp).

Trang HTML: https://www.hitava.cloud/huong-dan/luyen-thi-toeic-pro
