啟用指令碼授權和存取權

視目標而定,Apps Script API 需要不同類型的授權:

  • 在應用程式中使用 Apps Script API。
  • 允許其他應用程式管理您的指令碼專案資料或部署作業。

如果您需要在應用程式中使用 Apps Script API,您必須在應用程式的 Google Cloud 專案enable API。這可讓您建立 OAuth 憑證,讓應用程式的使用者能夠授權。

如要讓第三方應用程式管理指令碼專案的內容或部署,您必須授予存取權給指令碼專案。

在應用程式中使用 Apps Script API

如果您想在應用程式內使用 Apps Script API,則必須在應用程式的 GCP 專案中啟用 Apps Script API。啟用 Apps Script API 後,您可以建立 OAuth 憑證,並下載要納入應用程式的用戶端 ID 與密鑰。您也可以在 Google Cloud 控制台中監控 API 用量。

您可以使用這個精靈,在 API 控制台中建立或選取 Google Cloud 專案,並自動啟用該 API。或者,您也可以開啟主控台的「Manage Resources」(管理資源) 頁面,選取專案,然後使用專案的「APIs & services」(API 和服務) 資訊主頁搜尋並手動新增 Apps Script API。啟用 API 後,您就能在「APIs & services」(API 和服務) >「Credentials」(憑證) 面板中,為應用程式建立 OAuth 憑證、用戶端 ID 和用戶端密鑰。

Apps Script API 快速入門導覽課程將逐步介紹啟用 API 及為應用程式設定授權的完整程序。

將指令碼專案的存取權授予第三方應用程式

Apps Script API 可讓應用程式建立及修改指令碼及其部署。如果您授權給惡意的第三方應用程式,讓該應用程式繼續建立更多惡意指令碼或修改已有的指令碼行為,就有可能發生不良情況。

為了降低這種風險,在預設情況下,Apps Script API 無法存取您的指令碼專案,您必須明確授予 API 存取權,才能使用任何建立或修改指令碼或部署的應用程式。授予 API 存取指令碼的權限後,您授權的應用程式即可使用 API 管理您的指令碼專案。

如果您嘗試在未事先授予 API 存取權的情況下執行受影響的應用程式,就會發生錯誤。這項錯誤會在您授權應用程式後發生。

您可以使用 Apps Script 資訊主頁將指令碼專案的存取權授予 Apps Script API。您也可以隨時使用資訊主頁撤銷這項權限。當您授予 API 存取權時,就是「所有」應用程式的存取權。不過,個別應用程式仍須取得授權。

授予存取權之前,請務必瞭解允許應用程式修改指令碼可能會有風險。切勿授權任何疑似惡意的應用程式。