🔎 Kiểm tra kết nối

1. Giới thiệu

Tab 🖥️ Thiết bị dùng hai link để nói chuyện với Google Sheet quản lý thiết bị của khách: link triển khai Apps
Script (Web App URL) và link bảng tính. Mỗi khách hàng/công ty dùng một bộ link riêng. Trước khi dán link mới và
bấm ✅ Lưu & Áp dụng (đổi hẳn link toàn tool), nên bấm 🔎 Kiểm tra kết nối để chắc link vừa dán còn sống,
đúng định dạng, và Apps Script trả lời đúng — tránh dán nhầm link cũ, link đã xoá, hoặc link sai hẳn rồi mới biết
lúc các việc khác (Backup PC, Restore PC, Up Sheet…) báo lỗi.

Khi nào cần dùng:

• Mới nhận link Apps Script của một khách/công ty, muốn chắc link còn hoạt động trước khi lưu lại cho cả tool.
• Nghi ngờ link đang dùng đã hỏng (ví dụ deployment Apps Script đã bị xoá), muốn kiểm nhanh.

Nút này không làm: không lưu link vào cấu hình của tool, không đọc/ghi gì lên Google Sheet — chỉ gọi thử một
lần.

2. Trước khi bắt đầu

• Đã có file cấu hình của tool cạnh thanhd.exe (tool tự tạo từ lần chạy việc khác trước đó). Thiếu file này,
  cả 4 nút của nhóm "🔗 Liên kết Google Sheet" (gồm nút này) đều bị khoá/mờ, bấm không ăn gì.
• Đã có link Web App của Apps Script (dạng https://script.google.com/macros/s/.../exec). Cách lấy lần đầu
  cho một bảng tính mới:
  1. Mở Google Sheet sẽ dùng làm sổ quản lý thiết bị.
  2. Vào Extensions (Tiện ích mở rộng) → Apps Script, xoá nội dung mẫu, dán nội dung đã xuất bằng nút {{📄
     Export .gs}} của tool, lưu lại.
  3. Vào Deploy (Triển khai) → New deployment (Triển khai mới), chọn loại Web app.
  4. Trong hộp cấu hình: Execute as (Thực thi với quyền) = Me (chính tài khoản Google của bạn). Who has
     access (Ai có quyền truy cập) = Anyone (Bất kỳ ai) — tool gọi link bằng HTTP thuần, không có phiên đăng
     nhập Google kèm theo; chọn Anyone with Google account sẽ luôn bị từ chối.
  5. Bấm Deploy, cấp quyền khi Google hỏi (bấm Advanced (Nâng cao) → Go to... (unsafe) → Allow — cảnh báo
     bình thường cho script tự viết, không phải dấu hiệu virus).
  6. Copy đúng dòng Web app URL (không phải link Apps Script Editor) để dán vào ô link triển khai.
  7. Mỗi lần sửa code phải vào Manage deployments → New version → Deploy, sửa code rồi lưu KHÔNG đổi link cũng
     không tự áp dụng.
• Có mạng Internet thật trên máy để gọi được link.

3. Các bước thực hiện

1. Ở tab 🖥️ Thiết bị, nhóm 🔗 Liên kết Google Sheet, tìm ô "Link triển khai Apps Script...".
2. Dán link Web App vào ô này — nút đọc đúng nội dung đang nằm trong ô, không phải link đã lưu lần trước, nên
   dán xong bấm thử ngay được, không cần bấm ✅ Lưu & Áp dụng trước.
3. Bấm 🔎 Kiểm tra kết nối.
   Bạn sẽ thấy: nếu ô đang trống, tool báo ngay "Ô link triển khai đang trống." mà chưa gọi mạng. Nếu link không
   chứa đúng chuỗi script.google.com/macros/s/, tool báo "Link không đúng định dạng Apps Script Web App..." và
   cũng chưa gọi mạng.
4. Qua được hai lớp kiểm đó, tool mới thật sự gọi mạng tới link.
   Bạn sẽ thấy: hộp "Đang tải dữ liệu" hiện dòng "⏳ Đang gọi thử link Apps Script... (mạng chậm có thể mất tới 1
   phút)" kèm nút ✖ Hủy thao tác.
5. Chờ kết quả.
   Bạn sẽ thấy một trong ba kết quả:
   • ✅ "Kết nối thành công, link hoạt động bình thường." — link sống, Apps Script trả đúng định dạng mong đợi.
   • ⚠ "Link phản hồi nhưng không đúng định dạng JSON mong đợi:" kèm nội dung trả về — deployment tồn tại
     nhưng không phải Web App của tool, hoặc chưa Deploy phiên bản mới nhất.
   • ❌ "Không kết nối được tới link này. Kiểm tra lại link hoặc mạng." — mất mạng, sai hẳn URL, hoặc
     deployment đã bị xoá/archive.
6. Kiểm tra thành công thì bấm thêm ✅ Lưu & Áp dụng (xem bài hướng dẫn riêng) để link có hiệu lực thật cho cả tool — nút
   này chỉ gọi thử, chưa lưu gì.

4. Giải thích các mục trong cửa sổ

Mục	Tác dụng	Khi nào dùng / ghi chú
Ô "Link triển khai Apps Script..."	Nơi dán Web App URL để thử	Đọc đúng nội dung đang hiện trong ô, không phải giá trị đã lưu
Nút 🔎 Kiểm tra kết nối	Kiểm định dạng rồi gọi thử ?action=findMatch tới link	Không lưu gì, an toàn để thử nhiều link liên tiếp
Hộp "Đang tải dữ liệu" + nút ✖ Hủy thao tác	Hiện trong lúc đang gọi mạng	Gọi WinHttp trước; nếu bị chặn (hay gặp khi máy có proxy công ty) tự thử lại bằng curl.exe
Kết quả ✅ / ⚠ / ❌	Báo link sống hay không, đúng định dạng hay không	Xem mục 6 để xử lý từng trường hợp

5. Kiểm tra kết quả

• Thấy đúng dòng "✅ Kết nối thành công, link hoạt động bình thường." là link còn sống và đúng định dạng.
• Muốn chắc chắn hơn, mở trình duyệt dán thẳng link Web App vào thanh địa chỉ — Apps Script trả về một đoạn JSON
  là đúng, nếu trả về trang đăng nhập Google là thiếu quyền "Anyone".

6. Lỗi thường gặp và cách xử lý

Hiện tượng / thông báo	Nguyên nhân	Cách xử lý
"Ô link triển khai đang trống."	Chưa dán gì vào ô link	Dán link Web App Apps Script rồi bấm lại
"Link không đúng định dạng Apps Script Web App (phải chứa 'script.google.com/macros/s/')."	Dán nhầm link Apps Script Editor, link Google Sheet, hoặc link sai hẳn	Mở Apps Script Editor → Deploy → Manage deployments, copy đúng dòng "Web app URL"
"Không kết nối được tới link này. Kiểm tra lại link hoặc mạng."	Mất mạng, sai URL, hoặc deployment đã bị xoá/archive	Kiểm tra mạng; vào Apps Script xem deployment còn Active không, Deploy lại nếu cần
"Link phản hồi nhưng không đúng định dạng JSON mong đợi:" kèm nội dung	Link đúng cú pháp nhưng không phải Web App của tool, hoặc chưa để "Who has access" = Anyone	Kiểm lại cấu hình Deploy: Execute as = Me, Who has access = Anyone; Deploy > New version
Nội dung JSON trả về có chữ báo lỗi xác thực	Sheet khách đã đặt khoá chống dò link nhưng tool chưa có key bản quyền hợp lệ của đúng khách đó	Đăng nhập đúng key bản quyền của khách đó trong tool rồi thử lại
Hộp "Đang tải dữ liệu" đứng im quá 1 phút không tự tắt	Mạng rất chậm hoặc nghẽn giữa đường	Chờ thêm, hoặc bấm ✖ Hủy thao tác
Bấm ✖ Hủy thao tác nhưng vẫn phải chờ thêm gần 1 phút mới trả quyền điều khiển	Tool đang thử lại bằng đường vòng khác, chưa hủy được ngay	Cứ chờ hết khoảng đó; nếu cần gấp, đổi sang mạng khác rồi thử lại
Báo "Kết nối thành công" nhưng tool thật vẫn không dùng được link	Nút này chỉ gọi thử, không tự lưu link vào cấu hình	Bấm thêm ✅ Lưu & Áp dụng để link có hiệu lực thật
Nút 🔎 Kiểm tra kết nối bị mờ, bấm không phản ứng gì	Máy chưa có file cấu hình của tool cạnh thanhd.exe	Chạy một việc bất kỳ của tool trước để nó tự tạo file cấu hình

7. Lưu ý an toàn

• Không dán link Apps Script của khách hàng vào máy dùng để trình diễn, chụp màn hình hay hướng dẫn công khai.
• Nút này chỉ gọi thử một lần, không ghi gì vào Sheet và không lưu link vào cấu hình — an toàn để thử nhiều link
  liên tiếp.
• Link Web App URL cho phép đọc/ghi thẳng vào Sheet, không cần đăng nhập Google — giữ kín như một mật khẩu, không
  dán vào nơi công khai.

8. Câu hỏi thường gặp

Hỏi: Kiểm tra kết nối thành công rồi có cần bấm thêm nút nào không?
Đáp: Có. Bấm thêm ✅ Lưu & Áp dụng để link có hiệu lực thật cho các việc khác của tool (Restore PC, Up Sheet,
Check trùng lặp…). Kiểm tra kết nối chỉ là gọi thử.

Hỏi: Nút này có ghi gì lên Google Sheet không?
Đáp: Không. Nút chỉ gọi một hành động đọc thử, không ghi hay xoá dữ liệu nào trên Sheet.