啟用指令碼授權和存取權

根據目標,Apps Script API 需要不同類型的授權:

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

如果您需要在應用程式中使用 Apps Script API,則必須在應用程式的 Cloud Platform (GCP) 專案啟用 API。 這可讓您建立 OAuth 憑證,讓應用程式的使用者進行授權。

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

在應用程式中使用 Apps Script API

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

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

Apps Script API 快速入門導覽課程將逐步說明啟用 API 和設定應用程式授權的完整流程。

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

Apps Script API 可讓應用程式建立及修改您的指令碼及其部署作業。如果授權的第三方應用程式接著會建立更多惡意指令碼,或修改既有指令碼的行為,這可能會造成不良影響。

為降低風險,根據預設,Apps Script API 無法存取指令碼專案。您必須先明確授予 API 存取權,才能使用任何建立或修改指令碼或部署作業的應用程式。將 API 存取權授予指令碼後,您授權的應用程式就能使用 API 管理指令碼專案。

如果您嘗試先執行受影響的應用程式,但不想先授予 API 存取權,就會發生錯誤。您授權應用程式之後,就會發生這個錯誤。

您可以使用 Apps Script 資訊主頁授權 Apps Script API 存取指令碼專案。您也可以使用資訊主頁隨時撤銷這項存取權。當您授予 API 存取權時,就會對「所有」應用程式執行這項操作。但是,個別應用程式仍然必須取得授權。

授予存取權之前,請務必瞭解可能會讓應用程式修改指令碼的風險。切勿核准您認為任何惡意的應用程式。