OAuth Scopes 使用說明

最後更新日期：2025 年 11 月 2 日

為什麼需要這些權限？

SoFran 智慧營運網需要存取您的 Google Workspace 以提供自動化辦公功能。 以下列出所有需要的 OAuth Scopes（權限範圍）及其用途說明。

我們遵守Google API 服務使用者資料政策，僅使用這些權限提供核心服務功能，不會用於其他目的。

📋 權限請求方式

🔵
NextAuth.js 登入授權：

當您首次使用 Google 帳號登入 SoFran 時，系統會請求基本身份驗證和 Google Workspace 存取權限。

🟢
Apps Script 執行授權：

部分進階功能（如自動化腳本、郵件發送）在您首次使用部署的試算表功能時， 由 Google Apps Script 向您請求額外的權限。這些權限僅用於試算表內的自動化功能。

權限範圍詳細說明

🔐
OpenID 身份識別
openid
目的：驗證您的身份
使用方式：用於登入認證和建立使用者帳號
👤
基本個人資料
profile
目的：取得您的姓名和頭像
使用方式：在控制台顯示您的姓名和個人頭像
📧
Email 地址
email
目的：取得您的 Email 地址
使用方式：用於識別使用者帳號和部署記錄管理
📁
Google Drive 完整存取
https://www.googleapis.com/auth/drive
目的：建立和管理 Google Drive 檔案
使用方式：在您指定的資料夾中建立部署所需的試算表和表單
具體功能：
  • 建立新的資料夾
  • 複製範本試算表和表單
  • 讀取和更新由本服務建立的檔案
  • 不會存取您的其他個人檔案
📊
Google Sheets 完整存取
https://www.googleapis.com/auth/spreadsheets
目的：建立和編輯試算表
使用方式：建立考勤、業績、排班試算表並寫入資料
具體功能：
  • 建立新的試算表
  • 讀取和更新試算表內容
  • 設定儲存格格式和公式
  • 用於排班、考勤、業績資料處理
📝
Google Forms 完整存取
https://www.googleapis.com/auth/forms
目的：建立和管理 Google 表單
使用方式：建立考勤打卡表單和業績登錄表單
具體功能：
  • 建立新的 Google 表單
  • 設定表單問題和選項
  • 連結表單回應至試算表
  • 用於員工打卡和業績登錄
✏️
Google Forms 內容編輯
Apps Script
https://www.googleapis.com/auth/forms.body
目的：編輯表單的問題和結構
使用方式：設定表單欄位、選項和驗證規則（由 Apps Script 使用）
具體功能：
  • 修改表單問題
  • 設定選項和驗證
  • 調整表單設定
📃
Google Docs 完整存取
Apps Script
https://www.googleapis.com/auth/docs
目的：建立和編輯 Google 文件
使用方式：產生排班報表和業績管理與考勤管理的使用說明文件
📄
Google Documents API
https://www.googleapis.com/auth/documents
目的：透過 API 存取 Google 文件
使用方式：程式化建立和編輯文件內容
📦
Apps Script 專案管理
Apps Script
https://www.googleapis.com/auth/script.projects
目的：建立和管理 Apps Script 專案
使用方式：在部署時建立和更新試算表中的 Apps Script 程式碼（由 Apps Script 使用）
具體功能：
  • 建立新的 Apps Script 專案
  • 更新現有專案程式碼
  • 管理專案版本
🚀
Apps Script 部署管理
Apps Script
https://www.googleapis.com/auth/script.deployments
目的：部署 Apps Script 為網頁應用程式
使用方式：將 Apps Script 部署為可執行的應用程式（由 Apps Script 使用）
🌐
Apps Script Web App 部署
Apps Script
https://www.googleapis.com/auth/script.webapp.deploy
目的：部署 Apps Script 網頁應用程式
使用方式：啟用 Apps Script 的網頁應用程式功能（由 Apps Script 使用）
⏰
Apps Script 觸發器管理
Apps Script
https://www.googleapis.com/auth/script.triggers
目的：建立和管理時間驅動觸發器
使用方式：設定定時執行的自動化任務（由 Apps Script 使用）
具體功能：
  • 建立定時觸發器
  • 設定表單提交觸發器
  • 管理事件驅動的自動化
✉️
Apps Script 郵件發送
Apps Script
https://www.googleapis.com/auth/script.send_mail
目的：透過 Apps Script 發送郵件
使用方式：自動發送通知郵件（如排班結果、考勤提醒）（由 Apps Script 使用）
具體功能：
  • 發送排班通知
  • 寄送考勤提醒
  • 傳送業績報表

🔒 資料安全承諾

  • ✓我們僅存取和修改由本服務建立的檔案，不會瀏覽您的其他 Google 檔案
  • ✓您的 OAuth Token 安全儲存於 Google Firestore，並使用嚴格的存取控制
  • ✓所有資料傳輸使用 HTTPS 加密連線
  • ✓您可以隨時撤銷授權，前往 Google 帳號的「已連結的應用程式和網站」管理
  • ✓我們不會將您的資料提供給第三方或用於廣告目的

如何撤銷授權？

如您不再希望本服務存取您的 Google 帳號，可以隨時撤銷授權：

  1. 前往Google 帳號權限管理頁面
  2. 找到「SoFran 智慧營運網」並點擊
  3. 點擊「移除存取權」

撤銷後，您將無法使用部署功能，但已建立的檔案仍會保留在您的 Google Drive 中。

相關政策