Thanks to visit codestin.com
Credit goes to github.com

Skip to content

lowji194/GmailWebClient

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Ứng Dụng Đọc Gmail

Ứng dụng Google Apps Script để đọc email từ Gmail (hộp thư đến và spam) qua giao diện HTML hoặc API, hỗ trợ lọc email theo tiêu đề/người gửi.

Ảnh minh hoạ

Cấu trúc file

  • Code.gs: Chứa logic backend (xử lý API, lấy email, lọc email).
  • index.html: Giao diện HTML để hiển thị email, yêu cầu mã PIN để xác thực.

Chức năng và biến toàn cục

Biến toàn cục

  • PIN = "123456": Mã PIN để xác thực yêu cầu HTML và API.
  • PIN_EXPIRY_DAYS = 30: Thời hạn PIN (ngày, hiện chưa sử dụng trong logic).
  • filterEnabled = false: Kiểm soát việc lọc email. Nếu true, loại bỏ email có tiêu đề như "Khuyến mãi", "Bản tin" hoặc người gửi như "[email protected]", "[email protected]".

Hướng dẫn sử dụng API

Yêu cầu POST

  • URL: Lấy từ Google Apps Script sau khi deploy (ví dụ: https://script.google.com/macros/s/.../exec).
  • Phương thức: POST
  • Body JSON:
    {
      "pin": "123456",
      "limit": 10,
      "type": "inbox"
    }
    • pin: Mã PIN (phải khớp với PIN).
    • limit: Số lượng email tối đa (mặc định 100).
    • type: "inbox" (hộp thư đến) hoặc "spam" (thư rác).

Phản hồi

  • Thành công:
    {
      "success": true,
      "data": [
        {
          "id": "msg-id",
          "from": "Người Gửi <[email protected]>",
          "subject": "Tiêu đề",
          "date": "27-07-2025, 09:32",
          "snippet": "Nội dung xem trước...",
          "isUnread": false,
          "html": "<p>Nội dung HTML</p>"
        },
        ...
      ]
    }
  • Lỗi:
    {
      "success": false,
      "error": "Mã PIN không đúng"
    }

Kiểm tra API

Sử dụng curl hoặc Postman:

curl -X POST https://script.google.com/macros/s/.../exec \
-H "Content-Type: application/json" \
-d '{"pin":"123456","limit":10,"type":"inbox"}'

Hướng dẫn deploy

  1. Tạo dự án Google Apps Script:
    • Truy cập script.google.com.
    • Tạo dự án mới, tải lên Code.gsindex.html.
  2. Triển khai:
    • Nhấn Deploy > New deployment > Web app.
    • Cấu hình:
      • Execute as: Me (tài khoản của bạn).
      • Who has access: Anyone (hoặc Anyone, even anonymous để truy cập không cần đăng nhập).
    • Nhấn Deploy, sao chép URL web app.
  3. Kiểm tra:
    • Truy cập URL để xem giao diện HTML.
    • Gửi yêu cầu POST đến URL để kiểm tra API.

📫 Liên hệ với tôi


☕ Nếu bạn thấy dự án này hữu ích, một ly cà phê từ bạn sẽ là động lực tuyệt vời để mình tiếp tục phát triển thêm!

Mời cà phê

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published