進階 Google 服務

Apps Script 的進階服務可讓經驗豐富的開發人員使用 且設定比使用 HTTP 介面來得少。 進階服務基本上就是這些 Google API 的精簡包裝函式。他們 功能與 Apps Script 的 內建服務,例如提供 自動完成,而 Apps Script 則會處理 授權流程。 不過,您必須啟用進階服務, 您能以指令碼使用

如要瞭解哪些 Google API 可做為進階服務,請找到 「進階 Google 服務」一節中的 Reference,如要使用 Google API 無法做為進階服務,而是像任何其他連線一樣 external API

進階服務或 HTTP?

每項進階 Google 服務都會與一個公用 Google API 建立關聯。 在 Apps Script 中,您可以透過進階服務存取這些 API 直接使用 UrlFetch

如果使用進階服務方法,Apps Script 會處理 授權流程和優惠 自動完成支援功能。不過,您必須 請先啟用進階服務,才能使用 基礎架構此外,某些進階服務只會 功能的運作方式

如果您使用 UrlFetch 方法直接存取 API,系統會 基本上, 外部 API。這個方法 API 的各方面都能使用不過,您必須處理 API 請先取得授權您還必須建構任何必要的標頭,然後進行剖析 以及 API 回應

一般來說,盡可能使用進階服務是最簡單的方式, 使用 UrlFetch 方法時, 您需要的功能

需求條件

您必須符合下列條件,才能使用進階服務 規定:

  1. 必須啟用進階服務
  2. 您必須確認已啟用與進階服務相對應的 API Cloud Platform (GCP) 專案 指令碼使用的序列

    如果您的指令碼專案使用預設 GCP 專案 為 2019 年 4 月 8 日當天或之後建立,系統會自動啟用 API 請啟用進階服務並儲存指令碼專案如果發生以下情況: 還沒有測試過,您或許還能 您同意接受 Google CloudGoogle API 服務條款。

    如果您的指令碼專案使用 標準 GCP 專案 或較舊的預設 GCP 專案 必須啟用進階服務對應的 API 在 GCP 專案中手動執行。您必須擁有 GCP 專案的編輯權限 進行這項變更

請參閱 Cloud Platform 專案 瞭解詳情

啟用進階服務

如要使用進階 Google 服務,請按照以下說明操作:

  1. 開啟 Apps Script 專案。
  2. 按一下左側的「編輯器」圖示
  3. 在左側的「服務」旁邊,按一下「新增服務」
  4. 選取進階 Google 服務,然後按一下「新增」

啟用進階服務後,即可使用自動完成功能。

如何判定方法簽章

進階服務通常會使用相同的物件、方法名稱和參數 與對應的公用 API 一樣,但方法簽章會翻譯為 以用於 Apps Script。指令碼編輯器 自動完成函式 通常可提供充足的資訊,協助你快速上手。不過,以下將說明遵循規則 Apps Script 如何透過公開的 Google API 產生方法簽章。

向 Google API 發出的要求可接受各種類型的資料, 包含路徑參數、查詢參數、要求主體和/或媒體 上傳附件。某些進階服務也可接受特定的 HTTP 要求 標題 (例如 日曆進階服務)。

Google Apps Script 中對應的方法簽章具有下列功能 引數:

  1. 要求主體 (通常是資源) 為 JavaScript 物件。
  2. 路徑或必要參數,做為個別引數。
  3. 媒體上傳附件,格式為 Blob 引數。
  4. 選擇性參數,這是 JavaScript 物件,對應參數名稱 輕鬆分配獎金
  5. HTTP 要求標頭,這是將標頭名稱對應至標頭的 JavaScript 物件 輕鬆分配獎金

如果方法在任一指定類別中沒有任何項目,則屬於 簽名。

請注意,請注意以下特殊的例外狀況:

  • 如果是接受媒體上傳的方法,則會設定 uploadType 參數 。
  • Google API 中名為 delete 的方法在 Apps Script 中稱為 remove。 因為 delete 是 JavaScript 中的保留字詞。
  • 如果進階服務設為接受 HTTP 要求標頭,而您 設定要求標頭 JavaScript 物件,然後您也必須將 參數 JavaScript 物件 (如果您不使用 自選參數)。

支援進階服務

進階服務只是精簡的包裝函式,可以用來 以及 App Script 中的 API。因此,使用這些方法時如果發生問題 問題通常是基礎 API 問題,而非 Apps Script 本身。

如果您在使用進階服務時遇到問題, 使用基礎 API 支援操作說明進行回報。這些連結的連結 支援指示 Apps Script 的「參考資料」部分。