組織 Google 應用程式
什麼是組織 Google 應用程式、它讓成員的 Gmail、Google 日曆與 Google 雲端硬碟連接能做到哪些事,以及成員所屬的組織設有這個應用程式時,成員會看到什麼。
什麼是組織 Google 應用程式
有人連接 Gmail、Google 日曆或 Google 雲端硬碟時,Haruno 會透過一個 Google 應用程式向 Google 請求授權:可能是 Haruno 內建的應用程式,也可能是貴組織自己的應用程式。如果貴組織有這樣的應用程式,成員新的登入都會改經由它,Google 的授權畫面也會顯示它的名稱。它改變的是 Haruno 在對話與排程任務中能做的事;月底結帳從不讀取這些服務。
- 它是貴組織所掌控的 Google Cloud 專案中的一個「Desktop app」(電腦版應用程式)類型用戶端。每個組織只有一個;Mac 版與 Windows 版應用程式都沒有相關設定。
- Haruno 會將用戶端密鑰加密儲存,只提供給已登入成員的 Haruno 應用程式。任何 Haruno 畫面都不會顯示它。
- 它不會讓您存取任何人的信箱、日曆或雲端硬碟:每位成員都是登入自己的 Google 帳戶,登入資訊也只保留在他們自己的電腦上。
- 既有的連接只有在成員重新登入該連接器時,才會改用它。在 Windows 上,只有成員選擇「我的雲端硬碟」時,Google 雲端硬碟才會使用它。
財務團隊為什麼要使用它
如果您希望 Haruno 找出公司寄來的電子郵件並儲存其中的匯出檔附件,或處理您自己 Google 雲端硬碟中既有的資料夾,就需要一個。閱讀郵件與存取整個雲端硬碟都屬於 Google 限制的權限,Haruno 內建的應用程式不會要求這些權限;貴組織自己擁有的應用程式則可以。
| Haruno 能做的事 | 內建應用程式 | 貴組織的應用程式 |
|---|---|---|
| 傳送含附件的郵件;建立與重新命名 Gmail 標籤 | 可以 | 可以 |
| 搜尋與閱讀郵件、儲存附件、在郵件串中回覆、將郵件移到垃圾桶 | 不可以 | 可以 |
| 存取 Google 雲端硬碟 | 僅限 Haruno 建立的資料夾 | 成員自己「我的雲端硬碟」中的資料夾,前提是成員保留完整的雲端硬碟存取權 |
使用貴組織的應用程式時,成員可以在對話中請 Haruno 找出公司寄來的電子郵件,並儲存其中的匯出檔附件:
找出 Acme Corp 本週寄來、附有 QuickBooks 匯出檔的電子郵件,儲存附件,並告訴我存放在哪裡。除非您指定其他資料夾,否則 Haruno 會將附件存放在對話作業資料夾內的一個隱藏資料夾中(除非您開啟了其他資料夾,否則就是 Workspace 資料夾),因此請向它詢問存放路徑。兩種 Google 應用程式都不會把任何內容放進公司的帳冊,檔案必須由您自行加入:科目對應建立之前,請使用「新增資料」;科目對應建立之後,則使用「帳冊 ▸ 匯入匯出檔…」。若要找到已儲存的附件,請在「上傳公司檔案」視窗中按 ⇧⌘G,然後貼上路徑。兩種應用程式都能傳送郵件,因此以電子郵件向各公司索取匯出檔,並不需要組織應用程式。
您需要準備什麼
身為成員,除了組織內的 Haruno 帳戶之外,不需要任何其他東西:以該帳戶登入 Haruno,然後照常連接 Google 服務(《成員如何連接》)。每個人只能隸屬於一個組織(《組織》)。
「Internal」或「External」
如果每位成員連接的都是貴事務所自己 Google Workspace 中的帳戶,請選擇「Internal」(內部);若要連接其他任何 Google 帳戶,請選擇「External」(外部)。
| 目標對象 | 誰可以連接 | 成員會遇到的情況 |
|---|---|---|
| 「Internal」 | 只有您 Google Workspace 中的帳戶 | 不必每週重新登入,也不會出現「未經驗證的應用程式」警告。 |
| 「External」,處於「Testing」(測試)狀態 | 只有您加入的測試使用者 | Google 可能會警告它尚未驗證這個應用程式。每次登入大約維持七天。測試使用者清單與「Data Access」(資料存取)中的權限都由您自行維護。 |
| 「External」,已結束「Testing」狀態 | 測試使用者以外的帳戶 | 不必每週重新登入,但在 Google 驗證應用程式之前,成員可能會看到「未經驗證的應用程式」警告。Google 可能要求對敏感或受限範圍進行驗證;閱讀郵件與完整的雲端硬碟存取權都屬於受限範圍。 |
在 Mac 上,每週的登入到期前,Haruno 不會發出任何警告。下次使用該連接器時,該列會顯示「憑證遭拒 — 請重新登入以重新連接。」,對話中也會出現通知,例如:「Gmail 拒絕了已儲存的登入資訊。請在『連接器』中重新連接 — 在此之前工具都會停用。」之後最長一天內,或直到成員重新登入為止,新對話都不會納入該連接器。Google 的警告內容為「Google hasn't verified this app」(Google 尚未驗證這個應用程式):請告訴成員貴組織應用程式的名稱,讓他們只有在畫面上是這個應用程式時才繼續。
設定組織應用程式
目前帳戶控制台不提供註冊、替換或移除組織 Google 應用程式。如需設定或變更,請聯絡我們,或寫信至 info@inferara.com。貴組織先前儲存的應用程式仍會繼續運作。
成員如何連接
成員不需要做任何設定:照常連接即可,Google 的授權畫面會顯示組織應用程式的名稱。
在 Mac 上
- 使用貴組織的帳戶登入 Haruno。
查看側邊欄底部的帳號列,必要時請先登入。未登入 Haruno 時,Google 登入會經由 Haruno 內建的應用程式進行,而內建應用程式無法閱讀郵件。
- 按一下帳號列,然後選擇「連接器…」。
如果應用程式變更時,這個視窗已經開著,請先關閉再重新開啟。
- 在 Gmail 或 Google Calendar(Google 日曆)列上按一下「登入」,在 Google 的畫面上保持勾選所有權限,然後允許存取。
該列接著會顯示「透過貴組織的 Google 應用程式連接」;下方的確認開關預設為開啟(請參閱《連接器的確認開關》)。Google 雲端硬碟請參閱《連接 Google 雲端硬碟》。
成員在應用程式建立之前就已連接時
該連接會繼續運作;列上會顯示,例如:「Gmail 目前仍透過 Haruno 內建的 Google 應用程式連接。請重新登入以改用貴組織的 Google 應用程式。」請在該列的 ⋯ 選單中選擇「重新登入」;若是 Google 雲端硬碟,則依序按一下「編輯…」、「前往 Google 雲端硬碟」與「儲存」。改為完整的雲端硬碟存取權後,雲端硬碟原本選擇的資料夾會被清除:請用「選擇資料夾…」重新選擇。
在 Windows 上
在 Windows 上,Google 連接器(「設定 ▸ 連接器」中的「整合」卡片)使用同一個應用程式:只要成員已登入 Haruno,Gmail 與 Google 日曆的每個新連接都會使用它。Google 雲端硬碟則會先詢問:「Haruno 連線資料夾」使用內建應用程式,只能存取 Haruno 在其中建立的檔案;「我的雲端硬碟」使用貴組織的應用程式並取得完整的雲端硬碟存取權,前提是組織已儲存應用程式,且成員已登入 Haruno。
| 成員在 Windows 上看到的訊息 | 處理方式 |
|---|---|
| 「Sign in to Haruno before connecting My Drive.」(連接「我的雲端硬碟」前,請先登入 Haruno。) | 先登入 Haruno,再進行連接。 |
| 「My Drive requires a Google app configured by your organization. …」(「我的雲端硬碟」需要由貴組織設定的 Google 應用程式。…) | 請向我們洽詢應用程式(請見「設定組織應用程式」),或改選「Haruno 連線資料夾」。 |
| 「Your organization's Google app could not be checked, so this sign-in was stopped. …」(無法檢查貴組織的 Google 應用程式,因此已停止這次登入。…) | Haruno 無法取得貴組織的應用程式。請再試一次。 |
| 「Update this integration before connecting it with your organization's Google app.」(使用貴組織的 Google 應用程式連接前,請先更新這個整合項目。) | 先更新連接器,再進行連接。 |
| 「These Gmail permissions require an organization Google app. …」(這些 Gmail 權限需要組織 Google 應用程式。…) | 這次登入沒有使用組織應用程式。請向我們洽詢應用程式,然後重新連接 Gmail。 |
| 「Choose either the Haruno connection folder or My Drive before connecting Google Drive.」(連接 Google 雲端硬碟前,請選擇「Haruno 連線資料夾」或「我的雲端硬碟」。) | 在「Google 雲端硬碟存取權」欄位中選擇其中一項。 |
各項權限開放的功能
成員可以在 Google 的授權畫面上取消勾選項目。Gmail 必須具備傳送權限,Google 雲端硬碟至少需要一項雲端硬碟權限;其他項目取消勾選後仍可連接,只是能做的事較少。
| 範圍 | 要求者 | 允許的操作 |
|---|---|---|
| openid、userinfo.email | 貴組織的應用程式 | 得知連接的是哪一個 Google 帳戶。 |
| gmail.send(「Send email on your behalf」:代表您傳送電子郵件) | 兩種應用程式 | 傳送含附件的郵件。必要權限。 |
| gmail.labels | 僅限內建應用程式 | 建立與重新命名標籤(貴組織的應用程式改用 gmail.modify)。 |
| gmail.modify | 貴組織的應用程式 | 搜尋、閱讀與回覆郵件、儲存附件、管理標籤、將郵件移到垃圾桶。 |
| calendar.events | 兩種應用程式 | 讀取日曆,以及建立、變更或取消活動。 |
| drive.file | 內建應用程式;在 Mac 上也包括貴組織的應用程式 | 只能存取 Haruno 在它自己的資料夾中建立的檔案。 |
| drive | 貴組織的應用程式 | 存取成員自己的「我的雲端硬碟」;在 Mac 上,僅限成員選擇的資料夾。 |
成員取消勾選某項權限時
在 Mac 上,若未授予:
- 「Send email on your behalf」:Gmail 不會連接,並顯示「Google did not grant permission to send email, so Gmail was not connected. …」(Google 未授予傳送電子郵件的權限,因此 Gmail 並未連接。…)。
- 閱讀郵件(gmail.modify):Gmail 只能傳送郵件,其說明文字的結尾為「郵件閱讀需要貴組織設定的 Google 應用程式。」
- 所有雲端硬碟權限:Google 雲端硬碟不會連接,並顯示「Google 沒有授予 Drive 的存取權,因此並未建立連接。…」
- 只有完整的雲端硬碟存取權未授予:雲端硬碟只能存取 Haruno 資料夾;以這種方式縮小範圍的既有連接會警告「這個連接現在只看得到你 Google Drive 中的 Haruno 資料夾。…」
每種情況的解決方法都一樣:重新登入,並保持勾選所有權限。
這對排程任務代表什麼
在 Mac 上的排程任務中,貴組織的應用程式讓 Haruno 可以不經詢問就搜尋、閱讀郵件,並將郵件移到垃圾桶;Gmail 會將移到垃圾桶的郵件保留 30 天,之後就無法復原。除非任務獲准自行傳送,否則郵件與回覆仍會在「待確認」中等候;而具備閱讀郵件的權限時,每一封保留的郵件也會同時存放在成員的 Gmail 草稿中。請參閱《哪些會保留,哪些會立即執行》。
替換或移除組織應用程式
目前帳戶控制台同樣不提供替換或移除應用程式:請聯絡我們,或寫信至 info@inferara.com。解散組織也會一併移除應用程式。沒有組織應用程式時,新的 Gmail 與 Google 日曆登入會改用 Haruno 內建的應用程式,因此 Gmail 無法閱讀郵件;在 Mac 上,新的 Google 雲端硬碟連接只能存取 Haruno 資料夾;在 Windows 上,則要等到再次儲存應用程式後,才能連接「我的雲端硬碟」。
成員的連接會受到什麼影響
Google 端不會有任何變更;Mac 上的連接都會如下表所示。Mac 會在 Haruno 啟動或開啟「連接器」視窗時套用變更;成員不需要登出或重新啟動 Haruno。
| 變更 | 在 Mac 上 |
|---|---|
| 新密鑰,相同的用戶端 ID | 連接會繼續運作。 |
| 改用不同的用戶端 | 透過舊應用程式建立的連接會停止運作:「Gmail 先前是透過較舊的 Google 應用程式連接的。請重新登入,改用貴組織目前使用的 Google 應用程式。」 |
| 移除應用程式或解散組織 | 透過該應用程式建立的連接會停止運作:「Gmail 是透過一個已不再設定的 Google 應用程式連接的。請重新登入,改以 Haruno 內建的應用程式連接;內建應用程式的存取權限較少。」 |
| 成員登出 Haruno、離開組織或被移除 | 透過貴組織應用程式建立的連接會停止運作,直到成員在組織內重新登入 Haruno 為止。 |
| 以上任一情況,但連接是經由內建應用程式建立 | 繼續運作。 |
請成員重新登入:在該列的 ⋯ 選單中選擇「重新登入」;若是 Google 雲端硬碟,則依序按一下「編輯…」、「前往 Google 雲端硬碟」與「儲存」。雲端硬碟列可能會顯示「這個連接是透過一個已不再設定的 Google 應用程式建立的。請重新登入以重新連接。」移除應用程式後,雲端硬碟只會重新連接到 Haruno 自己的資料夾,資料夾也必須重新選擇。在此之前,新對話中不會提供該連接器的工具。
在 Windows 上,Gmail 與 Google 日曆的連接會沿用建立時所用的應用程式;成員必須重新連接,才會改用貴組織目前的應用程式。
遇到問題時
大多數登入問題都出在 Google Cloud 專案,只有管理員能修正。
在帳戶控制台中
目前帳戶控制台沒有 Google 應用程式卡片,因此其中不會出現任何與應用程式相關的訊息。如有任何與已儲存的應用程式有關的問題,請聯絡我們,或寫信至 info@inferara.com。
在成員的 Mac 上
| 成員看到的訊息 | 代表的意思與處理方式 |
|---|---|
| 「Google 未完成登入。如果不是你自己取消的,…」,或 Google 頁面上的「Error 403: access_denied」 | 成員取消了登入,或該帳戶不是測試使用者。請在「Test users」(測試使用者)中加入該帳戶。 |
| 「Google 未接受這次登入所使用的 Google 應用程式,…」(從「待確認」傳送時),或出現 Google 錯誤頁面,而不是授權畫面 | 用戶端已被刪除或停用,或其密鑰已不相符。必要時請建立新的「Desktop app」用戶端,並請我們替換應用程式。成員需重新登入;如果該列仍顯示「請在瀏覽器中完成登入…」,請先按一下「取消」。 |
| 對話、保留的項目(「Google 拒絕了這項操作(403)。」)或雲端硬碟設定面板(「Request failed (403) …」,即要求失敗)回報該 API 未曾在專案中使用或已停用 | 啟用該服務的 API。不需要重新登入。 |
| 「你的 Google Workspace 管理員封鎖了這個應用程式,因此無法連接。…」 | 擁有該電子郵件地址的 Workspace(可能是某家公司的 Workspace)必須允許這個應用程式。 |
| 「這個 Google 帳號不屬於貴組織的 Google Workspace,…」 | 貴組織的應用程式是「Internal」。請使用工作帳戶登入;其他電子郵件地址需要「External」應用程式。 |
| 「目前無法讀取貴組織的 Google 應用程式,…」 | Haruno 會停止登入,而不會改經由其他應用程式登入。請幾分鐘後再試一次。 |
| 「目前無法使用這個連接 — …請解鎖鑰匙圈後再試一次。」 | 解鎖 Mac 的「登入」鑰匙圈。 |
| 「Google returned no refresh token. …」(Google 未傳回更新權杖。…) | 在該 Google 帳戶的設定中移除 Haruno 的存取權,然後重新登入。 |
已儲存的登入遭拒(「憑證遭拒 — 請重新登入以重新連接。」)及其他連接器問題,請參閱《疑難排解:連接器》。