Hướng dẫn kết nối Google

← Quay lại Cài đặt

Kết nối Google với Sellkit

Cho phép Sellkit tự động chia sẻ Google Drive, thêm vào Calendar, ghi Sheet, và quản lý Groups khi có đơn hàng mới.

Yêu cầu: Tài khoản Google Workspace hoặc Gmail. Quản trị viên cần bật quyền truy cập cho ứng dụng.

Bước 1: Tạo dự án trên Google Cloud Console

  1. Truy cập console.cloud.google.com
  2. Nhấn Select a project (góc trên bên trái) → New Project
  3. Đặt tên dự án (VD: Sellkit) → Create
  4. Đợi vài giây, sau đó chọn dự án vừa tạo

Bước 2: Bật các API cần thiết

  1. Vào APIs & Services → Library
  2. Tìm và bật lần lượt các API sau:
    • Google Drive API — chia sẻ file/thư mục
    • Google Calendar API — tạo lịch hẹn
    • Google Sheets API — ghi dữ liệu vào bảng tính
    • Admin SDK API — quản lý Google Groups (chỉ Workspace)
  3. Nhấn Enable cho mỗi API

Bước 3: Cấu hình OAuth Consent Screen

  1. Vào APIs & Services → OAuth consent screen
  2. Chọn External (hoặc Internal nếu chỉ dùng trong tổ chức) → Create
  3. Điền thông tin:
    • App name: Sellkit
    • User support email: email của bạn
    • Developer contact: email của bạn
  4. Ở bước Scopes, nhấn Add or Remove Scopes và thêm: 
    https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/admin.directory.group
  5. Ở bước Test users, thêm email Google của bạn
  6. Nhấn Save and Continue qua các bước còn lại

Bước 4: Tạo OAuth Client ID

  1. Vào APIs & Services → Credentials
  2. Nhấn + Create Credentials → OAuth client ID
  3. Chọn Application type: Web application
  4. Đặt tên: Sellkit OAuth
  5. Ở mục Authorized redirect URIs, thêm: 
    http://localhost:8080/api/v1/oauth/google/callback

    Khi deploy lên production, thay bằng URL thật của Sellkit API.

  6. Nhấn Create
  7. Ghi lại Client ID và Client Secret

Bước 5: Cấu hình Sellkit

Thêm vào file config.yaml:

integrations:
  google_oauth:
    client_id: "YOUR_CLIENT_ID.apps.googleusercontent.com"
    client_secret: "GOCSPX-YOUR_SECRET"

Khởi động lại Sellkit server.

Bước 6: Kết nối trong Sellkit

  1. Vào Cài đặt
  2. Nhấn nút Kết nối Google
  3. Đăng nhập tài khoản Google và cho phép quyền truy cập
  4. Cửa sổ popup sẽ tự đóng. Trạng thái chuyển sang Đã kết nối
  5. Nhấn Kiểm tra kết nối để xác nhận
Lưu ý: Token tự động làm mới. Nếu bạn thu hồi quyền trong Google Account, cần kết nối lại.

Sau khi kết nối, bạn có thể sử dụng các template workflow: Share Google Drive, Clone Google Drive, Event (Calendar + Group + Sheet + Email).