組織 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 找出公司寄來的電子郵件,並儲存其中的匯出檔附件:

text
找出 Acme Corp 本週寄來、附有 QuickBooks 匯出檔的電子郵件,儲存附件,並告訴我存放在哪裡。

除非您指定其他資料夾,否則 Haruno 會將附件存放在對話作業資料夾內的一個隱藏資料夾中(除非您開啟了其他資料夾,否則就是 Workspace 資料夾),因此請向它詢問存放路徑。兩種 Google 應用程式都不會把任何內容放進公司的帳冊,檔案必須由您自行加入:科目對應建立之前,請使用「新增資料」;科目對應建立之後,則使用「帳冊 ▸ 匯入匯出檔…」。若要找到已儲存的附件,請在「上傳公司檔案」視窗中按 ⇧⌘G,然後貼上路徑。兩種應用程式都能傳送郵件,因此以電子郵件向各公司索取匯出檔,並不需要組織應用程式。

將每家公司的雲端硬碟資料夾放在您自己的「我的雲端硬碟」中
在 Mac 上,Haruno 只能存取成員自己「我的雲端硬碟」中的資料夾:公司與您共用的資料夾(「與我共用」)即使透過捷徑也無法存取,共用雲端硬碟同樣無法存取。因此,請在您自己的「我的雲端硬碟」中為每家公司建立資料夾,與該公司共用,再於「Haruno 可以使用的資料夾」中勾選它。內建應用程式只看得到它自己建立的資料夾,而且看不到其他人在 Google 雲端硬碟中放進該資料夾的檔案。
Haruno 讀取的郵件會成為對話的一部分
閱讀郵件的權限涵蓋成員的整個信箱,無法將 Haruno 限制在單一標籤或單一公司的郵件。對話或排程任務讀取的內容都會成為對話的一部分,並經由 Inferara 的託管服務傳送給模型供應商。請告訴成員,哪些郵件可以請 Haruno 讀取,哪些不可以。

您需要準備什麼

身為成員,除了組織內的 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 Workspace 的電子郵件地址
「Internal」應用程式只接受您自己 Workspace 中的帳戶,而公司的 Workspace 管理員也可以封鎖他們未核准的應用程式。只有該管理員能解除封鎖。

設定組織應用程式

目前帳戶控制台不提供註冊、替換或移除組織 Google 應用程式。如需設定或變更,請聯絡我們,或寫信至 info@inferara.com。貴組織先前儲存的應用程式仍會繼續運作。

成員如何連接

成員不需要做任何設定:照常連接即可,Google 的授權畫面會顯示組織應用程式的名稱。

在 Mac 上

  1. 使用貴組織的帳戶登入 Haruno。

    查看側邊欄底部的帳號列,必要時請先登入。未登入 Haruno 時,Google 登入會經由 Haruno 內建的應用程式進行,而內建應用程式無法閱讀郵件。

  2. 按一下帳號列,然後選擇「連接器…」。

    如果應用程式變更時,這個視窗已經開著,請先關閉再重新開啟。

  3. 在 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 的存取權,然後重新登入。

已儲存的登入遭拒(「憑證遭拒 — 請重新登入以重新連接。」)及其他連接器問題,請參閱《疑難排解:連接器》。

後續步驟

成員從「連接器」視窗進行連接。