Apps Script 需要使用者授權才能存取下列中的私人資料: 內建 Google 服務或 進階 Google 服務。
授予存取權限
![](https://developers.google.cn/static/apps-script/images/new-auth-1.png?authuser=8&hl=zh-tw)
![](https://developers.google.cn/static/apps-script/images/new-auth-2.png?authuser=8&hl=zh-tw)
Apps Script 會決定授權範圍 (例如 Google 試算表的存取方式) 檔案或 Gmail)。程式碼屬於 註解排除後仍可產生授權要求,如果指令碼需要 表示授權對話方塊後,此處會顯示一個授權對話方塊 此程序的第一步 是將程式碼簽入執行所有單元測試的存放區中
您先前授權的指令碼也會要求使用其他指令碼 。指令碼不得要求 必須獲得授權,才能以網頁應用程式形式存取指令碼: 指令碼擁有者的使用者身分。
撤銷存取權限
如要撤銷指令碼對資料的存取權,請按照下列步驟操作:
- 請造訪 「權限」頁面 登入 Google 帳戶。(如要前往 造訪 Google.com,然後 按一下畫面右上角的帳戶圖片。接著,按一下 「我的帳戶」>「已連結的應用程式與」網站下的 "登入與「安全性」和「管理應用程式」)。
- 找出要撤銷授權的指令碼,然後按一下該指令碼的名稱, 按一下右側的「移除」,然後在顯示的對話方塊中按一下「OK」。
權限和指令碼類型
指令碼使用的使用者身分,因此能存取的資料, 會視指令碼的執行情況而定,如下表所示 。
指令碼類型 | 指令碼會以下列身分執行: |
---|---|
獨立式、 外掛程式,或 繫結至文件、試算表、簡報或表單 | 使用者使用鍵盤 |
試算表中的自訂函式 | 匿名使用者; 但配額限制 才會計入鍵盤上的使用者 |
網頁應用程式或 Google 協作平台小工具 | 鍵盤或指令碼擁有者的使用者 (影響因素) 已選取的選項 部署應用程式時 |
可安裝觸發條件 | 建立觸發條件的使用者 |
試算表、文件、簡報和表單的手動授權範圍
如果您要建立外掛程式或其他指令碼 使用試算表服務; 文件服務 簡報服務,或 表單服務:您可以強制執行授權 對話方塊,只要求存取使用外掛程式或指令碼的檔案。 而不是使用者的所有試算表、文件或表單方法是附上 在檔案層級註解中納入以下 JsDoc 註解:
/**
* @OnlyCurrentDoc
*/
如果你的指令碼包含相反註解 @NotOnlyCurrentDoc
,可以使用反對註解
包含宣告的程式庫
@OnlyCurrentDoc
,但主指令碼實際上需要存取超過
。
外掛程式的授權生命週期
Google 試算表、文件、簡報和表單的外掛程式
一般採用的授權模式與
「繫結」至文件。某些情況下
然而,其 onOpen(e)
和 onEdit(e)
函式會在
此為無授權模式,多了一些其他複雜問題。如要
相關資訊,請參閱
外掛程式授權生命週期指南。
OAuth 應用程式使用者限制
使用 OAuth 存取 Google 使用者資料的應用程式,包括 Google Apps 指令碼專案有授權限制。詳情請見 OAuth 應用程式使用者限制 。