Tạo mã ứng dụng Google (người quản lý làm 1 lần)

App chạy trên máy cần một mã ứng dụng Google (OAuth Client ID) thì mới đăng nhập Google và sửa được Google Sheets. Chỉ một người làm việc này một lần, mất khoảng 10 phút. Người trong team chỉ cần nhận file zip đã có sẵn mã.

Dùng tài khoản Google của bạn (hoặc của công ty) để làm các bước dưới.

Bước 1: Tạo dự án

1. Mở https://console.cloud.google.com
2. Ở góc trên bên trái, bấm ô chọn dự án → Dự án mới (New project).
3. Đặt tên Tinh tien seeding → Tạo. Sau đó chọn đúng dự án vừa tạo.

Bước 2: Bật Google Sheets API

1. Mở https://console.cloud.google.com/apis/library/sheets.googleapis.com
2. Bấm Bật (Enable).

Bước 3: Màn hình xin quyền (Google Auth Platform)

1. Mở https://console.cloud.google.com/auth/overview → Bắt đầu (Get started).
2. Thông tin ứng dụng: tên Tinh tien seeding, email hỗ trợ là email của bạn.
3. Đối tượng (Audience):
   • Team dùng Gmail cá nhân: chọn Bên ngoài (External).
   • Cả team dùng chung tên miền Google Workspace của công ty: chọn Nội bộ (Internal). Cách này không có cảnh báo "chưa xác minh" và không cần làm mục 5.
4. Nhập email liên hệ, đồng ý điều khoản, rồi bấm Tạo.
5. (Chỉ khi chọn External) Chọn một trong hai cách:
   • Cách A, nên dùng: Xuất bản. Vào Đối tượng (Audience) → Xuất bản ứng dụng (Publish app) → xác nhận để chuyển sang Đang hoạt động (In production).
     • Ứng dụng không cần gửi Google xác minh. Lần đầu đăng nhập, người dùng chỉ thấy cảnh báo "chưa xác minh", bấm Nâng cao → Đi tới Tinh tien seeding là xong. Giới hạn 100 người dùng.
     • Đăng nhập một lần là dùng được lâu, không phải đăng nhập lại.
   • Cách B: Để chế độ Thử nghiệm (Testing). Dùng khi chưa muốn xuất bản.
     1. Vào Đối tượng (Audience) → mục Người dùng thử (Test users) → Thêm người dùng (Add users).
     2. Nhập email Google của từng người trong team (tối đa 100), mỗi email một dòng → Lưu.
     3. Người không có trong danh sách sẽ bị Google chặn (access_denied). Có người mới thì quay lại thêm email.
     4. Ở chế độ này Google bắt mọi người đăng nhập lại sau mỗi 7 ngày. App sẽ tự hiện màn hình đăng nhập khi hết hạn. Muốn hết phải đăng nhập lại thì chuyển sang Cách A.

Bước 4: Tạo mã ứng dụng

1. Mở https://console.cloud.google.com/auth/clients → Tạo ứng dụng khách (Create client).
2. Loại ứng dụng: chọn Ứng dụng máy tính (Desktop app). Tên: Tinh tien seeding → Tạo.
3. Google hiện Client ID (dạng 1234...apps.googleusercontent.com) và Client secret (dạng GOCSPX-...). Giữ trang này mở.

Bước 5: Dán mã vào app

1. Bấm đúp start.cmd. Trình duyệt mở màn hình "Cài đặt lần đầu".
2. Dán Client ID và Client Secret → Lưu mã.
3. Bấm Đăng nhập bằng Google để thử.

Mã được lưu ở config\google-oauth.json. Với loại "ứng dụng máy tính", Google cho phép đóng gói mã này kèm app gửi cho team. Mã chỉ dùng để xin đăng nhập: mỗi người vẫn phải tự đăng nhập và tự bấm "Cho phép" bằng tài khoản của họ.

Bước 6: Gửi cho team

Bấm đúp dong-goi-cho-team.cmd. App tạo file TinhTienSeeding-team.zip (đã có mã, không kèm đăng nhập Google của bạn). Gửi file này cho team, kèm HUONG-DAN-MAY-MOI.txt.

Lỗi hay gặp