啟用指令碼授權和存取權

根據您的目標,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 存取權時,此操作適用於「所有」應用程式。不過,個別應用程式仍需取得授權。

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