本頁內容由機器翻譯而成,以英文原文為準。

管理員指南:Ascripto 與 Google Workspace

上次更新:2026 年 11 月 9 日

寫給被要求允許某項存取的 Google Workspace 管理員或超級管理員,以及任何想評估 Ascripto 會接觸哪些內容的人。先說明機制,並使用 Google 自己的用語。

Ascripto 要求什麼,以及向誰要求

授權由誰授予在何處允許的內容
登入每一位使用 Ascripto 的人Google 的登入畫面openid、email、profile。身分以 Google 帳戶固定不變的主體識別碼(subject)與託管網域(hosted domain)為依據,絕不以電子郵件地址為依據
目錄,唯讀一位 Google Workspace 管理員從 Ascripto 前往的 OAuth 同意畫面(「歡迎使用 Ascripto」頁面或「設定」→「連線」)admin.directory.user.readonly 與 admin.directory.domain.readonly:使用者及其姓名、職稱、部門、電話、機構單位與自訂屬性;組織已驗證的網域。不會讀取群組
簽名一位超級管理員管理控制台 →「安全性」→「存取權與資料控管」→「API 控制項」→「管理全網域委派設定」授予 Ascripto 服務帳戶的 www.googleapis.com/auth/gmail.settings.basic,其用戶端 ID 顯示在頁面上。僅用於 users.settings.sendAs

Ascripto 絕不會讀取、傳送或刪除郵件。Ascripto 對 Google 資料的使用受《Google API 服務使用者資料政策》(Google API Services User Data Policy)約束,包括其中的「有限使用」(Limited Use)規定;相關聲明載於隱私權政策:ascripto.com/zh-tw/privacy/。

為何採用全網域委派,而不是從 Marketplace 安裝

有兩個原因,而且即使 Marketplace 上架之後,這兩個原因仍然成立:

  1. 要讀取或寫入非呼叫者本人信箱的「選擇寄件地址」(send-as)簽名,只有具備全網域授權的服務帳戶用戶端才做得到。個別使用者的同意無法做到。
  2. Google 沒有提供 gmail.settings.basic 的唯讀版本。稽核只會讀取,但此授權必然同時允許寫入。

Google 已於 2026 年 10 月 17 日驗證 Ascripto 的 OAuth 應用程式(品牌資訊與機密範圍),因此目錄授權的同意畫面不會顯示「未經驗證的應用程式」警告。簽名的委派項目仍須在管理控制台中手動建立,而範圍就是上表所列的那些。

頻率與機制

活動頻率機制
目錄變更發生時即時處理:Google 會將每項變更通知 Ascripto,Ascripto 會在當下、一分鐘後與五分鐘後各讀取該人員一次Admin SDK Directory API users.watch,每種變更(新增、變更、刪除、還原)各一個頻道,每兩天更新一次,並以 channels.stop 停止;以 users.get 讀取該人員
目錄讀取每小時一次;缺少通知頻道期間每 15 分鐘一次;以及按下「立即讀取」時Admin SDK Directory API users.list、domains.list
稽核每天一次,以及按下「重新檢查」時每個人一次 sendAs.list;將主要地址的簽名與目錄資料比對
部署在經過檢閱的部署時;之後對新進人員與有變更的資料自動進行每個人一次 sendAs.patch,每秒約寫入二十次。系統會先讀取每個信箱,只有在內容不同時才寫入,除非勾選了「即使已是最新也重新寫入」
匯入依要求進行對所選的人員執行 sendAs.get;將值與此人的目錄資料比對

使用的是 sendAs.patch 而不是 sendAs.update,因此部署絕不會清除人員的顯示名稱、回覆地址或別名旗標。只會寫入新郵件簽名:Gmail API 沒有對應回覆和轉寄選項的欄位,因此簽名的回覆版本不會部署至 Gmail。

稽核比對的內容

針對每個人,將 Gmail 用於新郵件的簽名與目錄資料比對。問題:

問題檢測方式
沒有簽名簽名為空
缺少姓名文字中沒有此人的姓名
缺少職稱文字中沒有目錄中的職稱
缺少公司電話文字中沒有目錄中的公司電話
沒有標誌簽名中沒有標誌圖片
無法讀取Google 拒絕存取該信箱;另外計算,絕不算作符合或不符合品牌規範

以下項目不在檢查範圍內,數字旁邊也會如此說明:某人可能為回覆和轉寄另外選取的簽名(Gmail 將其存放在網頁版設定中,沒有任何 API 會揭露目前使用的是哪一個)、在 Gmail 應用程式內設定的「行動版簽名」(僅存在於裝置上,任何 API 都看不到)、字型、大小與顏色,以及某人在部署的內容之外自行加入的任何內容。

部署寫入的內容

為該人員轉譯出的 HTML(圖片託管在 img.ascripto.com 之下您工作區專屬的名稱,因為 Gmail 簽名是一段 HTML 字串,無法內嵌圖片),以及相對應的純文字。Gmail 會在網頁版與 Gmail 應用程式中套用。部署會略過在目錄中已停權的人員、地址不在組織網域內的人員,以及沒有任何簽名觸及的人員。

離職人員

從目錄中移除的人員會移至 Ascripto 的資源回收筒(預設為 7 天,可在「設定」→「連線」中設定為最長一年),並停止受管理。Ascripto 不會再寫入此人的信箱,也不會清除其中既有的簽名。已停權的使用者在停權期間不會被寫入。

雙重簽名

如果管理控制台中啟用了「附加註腳」(Append footer)(「應用程式」→「Google Workspace」→「Gmail」→「法規遵循」),Google 會將註腳加在每位使用者自己的簽名下方,包括 Ascripto 寫入的簽名。一旦由 Ascripto 負責帶入法律文字,請在設定了註腳的每個機構單位關閉註腳。

故障模式,以及產品回報的方式

發生的情況Ascripto 顯示的內容修正方式
委派項目不存在或已被刪除「Google 拒絕開啟信箱。簽名存取權可能已在您的管理控制台中撤銷。」稽核或部署會停止;計數會停留在當時的進度重新加入用戶端 ID 與範圍。這是在權杖端點偵測到的(unauthorized_client),因此期間不會接觸任何信箱
目錄的同意已被撤銷,或給予同意的管理員失去了該角色「設定」→「連線」:「連線已撤銷。請重新連線以再次讀取目錄。」以目前的管理員身分「重新連線」
Google 需要一段時間才會套用新的委派「尚未允許」,並每 20 秒重新檢查一次請稍候;依 Google 的說明最多需要 24 小時,通常只要幾分鐘
檢查或讀取在 Ascripto 這一端失敗會如實說明,並重試不需要處理

撤銷 Ascripto 的存取權

  1. 簽名:管理控制台 →「安全性」→「存取權與資料控管」→「API 控制項」→「管理全網域委派設定」→ Ascripto 用戶端 →「刪除」。稽核與部署會立即停止。
  2. 目錄:由給予同意的管理員在其 Google 帳戶 →「連結的應用程式」(myaccount.google.com/linkedapps)中移除 Ascripto(或在「設定」→「連線」中:Google 拒絕下一次讀取後,該連線會標示為已撤銷)。
  3. 已寫入的簽名會留在人員的 Gmail 中;Ascripto 絕不會清除這些簽名。

資料處理方式

計費使用者

在 Google Workspace 上,計費使用者是指當月任何時間點其 Gmail 帶有您目前簽名的人,不論是因為部署寫入了該簽名,或是部署或稽核發現該簽名仍在。整個月都處於停權或已移除狀態的人不計入。當月至今的人數顯示在「設定」→「帳單」中。

資料來源