進階 API

開發人員可利用 Google Ads 指令碼中的進階 API，連結至特定公開 Google API，設定程序比使用 HTTP 介面更簡便。這些 API 的使用方式與指令碼內建服務類似，且同樣提供自動完成和自動授權等便利功能。

請參閱程式碼片段頁面，查看如何使用這些 API 的範例。

可用的進階 API

Google Analytics
注意：「進階 API」對話方塊中的 Analytics 進階 API 會指定已停用的通用 Analytics 第 3 版 API，因此要求會失敗。Google Ads 指令碼不支援 Google Analytics 4 AnalyticsData 或 AnalyticsAdmin 進階服務。如要透過指令碼查詢 Google Analytics 4 資料，請使用 UrlFetchApp 服務和 OAuth 2.0，將 HTTPS 要求傳送至 Google Analytics Data API。您也可以將 Google Analytics 4 資源連結至 Google Ads 帳戶，直接分享網站和應用程式轉換資料。如需設定操作說明，請參閱 Analytics 設定指南。
Google BigQuery
您可以將大量資料載入 Google Cloud Storage，然後使用 Google BigQuery 查詢這些資料。舉例來說，您可以載入過去 10 年的公開天氣資料，然後在指令碼中查詢某個區域的平均溫度，並使用該資訊調整出價。另一個用途是分析帳戶多年來的成效資料。
Google 日曆
指令碼可以為未來的工作建立事件 (例如在 2 週後執行廣告活動成效報表)，或根據您在日曆上建立的項目執行動作 (例如在特定日期啟用廣告活動)。
Google 簡報
指令碼可將廣告活動詳細資料或統計資料匯出至 Google 簡報，以適合簡報的格式發布這類資訊。
Google Tasks
指令碼可以建立未來工作的提醒清單 (例如，從今天起兩週內執行廣告活動成效報表)，或根據您在提醒清單中建立的項目執行動作 (例如，在特定日期啟用廣告活動)。
Merchant API
指令碼可使用 Merchant API 上傳及管理產品資訊，以及管理 Google Merchant Center 帳戶。在指令碼中，這項功能可用於檢查產品資訊，以及將特定產品連結至特定廣告。Merchant API 包含多個子 API，可在「進階 API」對話方塊中個別啟用。如要進一步瞭解如何連結 Google Merchant Center 帳戶，請參閱「註冊為開發人員」指南。
購物內容
指令碼可以使用 Google Content API for Shopping 上傳及管理產品資訊，以及管理 Google Merchant Center 帳戶。在指令碼中，這項功能可用於檢查產品資訊，並將特定產品連結至特定廣告。注意：Content API for Shopping 將於 2026 年 8 月 18 日停用。請改用上一節所述的 Merchant API。
YouTube 和 YouTube 數據分析
您可以擷取及更新影片、播放清單等，以及影片的成效資料，以便做出出價決策。

啟用進階 API

如要查看哪些 Google API 可做為進階 API 使用，請按一下頂端編輯器列中的「Advanced APIs」，顯示「Advanced APIs」對話方塊。選取要啟用的 API。

按一下「儲存」即可儲存所選項目，並返回指令碼編輯器。系統會為指令碼啟用新 API，並在自動完成清單中顯示。

其他注意事項

使用進階 API 時，請注意下列事項。

依附元件

只有在帳戶中建立指令碼的使用者，才能變更該指令碼的進階 API 依附元件。

權限

存取進階 API 時，指令碼會使用授權指令碼的使用者權限。授權使用者必須具備指令碼所需的所有資料存取權。舉例來說，如要使用 BigQuery 進階 API，授權使用者必須具備目標 Google 雲端專案和 BigQuery 資料集的必要權限。

2019 年 5 月前指令碼的注意事項

如果是 2019 年 5 月前建立的指令碼，您可能需要在指令碼相關聯的 Google 雲端專案中，手動啟用相關 API。如果進階 API 對話方塊中顯示 Google Cloud 控制台連結，就表示指令碼受到影響。

啟用進階 API

如果是 2019 年之前的指令碼，您必須手動啟用要在指令碼中使用的每個進階 API：

  1. 按一下「Advanced APIs」按鈕。在隨即顯示的對話方塊視窗中，按一下 Google Cloud 控制台連結。
  2. 如果尚未選取專案，請從「Project」(專案) 下拉式選單中選取。
  3. 在搜尋列中輸入 API 名稱，搜尋要在指令碼中使用的 API。
  4. 從搜尋結果中選取 API，然後在後續頁面中點選「啟用」按鈕。

如果建立指令碼的使用者後來從帳戶中移除，則任何嘗試存取指令碼的新使用者，都會收到提示，要求再次啟用進階 API 依附元件，並重新授權指令碼。