進階 API

經驗豐富的開發人員可透過 Google Ads 指令碼中的進階 API,連線至特定公用 Google API,設定方式比使用 HTTP 介面少。這些 API 的使用方式與指令碼的內建服務類似,且提供相同的便利功能,例如自動完成和自動授權。

Advanced API 可能的用途

Google Analytics (分析)
你可以使用 Google Analytics (分析) 追蹤網站流量,並據此調整廣告活動出價。只要將 Google Analytics (分析) 資源連結至 Google Ads 帳戶,即可分析網站上的客戶活動。並透過這項資訊瞭解 Google Ads 為您的網站帶來了多少人潮或業績,再據以改善廣告和網站。如要進一步瞭解如何連結 Analytics (分析) 和 Google Ads 帳戶,請前往說明中心
Google BigQuery
您可以將大量資料載入 Google Cloud Storage,然後使用 Google BigQuery 查詢該資料。例如,您可以載入過去 10 年的公開天氣資料,然後在指令碼中查詢地區的平均溫度,使用該資訊來調整出價。另一個做法是累積好幾年的帳戶成效資料。
YouTube 和 YouTube 數據分析
您可以擷取並更新影片、播放清單等和影片的成效資料,做為出價決策的依據。
Google 日曆
指令碼可以為日後的工作建立事件 (例如從今天起 2 週後為廣告活動執行成效報表),或者根據您在日曆上建立的項目執行動作 (例如在特定日期啟用廣告活動)。
購物內容
您的指令碼可以在 Apps Script 中使用 Google Content API for Shopping。這個 API 可讓 Google Merchant Center 使用者上傳及管理產品資訊,以及管理 Merchant Center 帳戶。在指令碼中,這很適合用來查看產品資訊,並將特定產品連結至特定廣告。
Google Tasks
指令碼可以為日後的工作建立提醒清單 (例如從今天起兩週後為廣告活動執行成效報表),或是根據您在提醒清單中建立的項目執行動作 (例如在特定日期啟用廣告活動)。
Google 簡報
您的指令碼可將廣告活動詳細資料或統計資料匯出至 Google 簡報,以透過可顯示的格式發布此類資訊。

啟用進階 API

如要查看哪些 Google API 可做為進階 API,請按一下頂端編輯器列的「Advanced API」按鈕。

系統會顯示「Advanced API」對話方塊。勾選要啟用的 API。

接著,按一下「Google API Console」連結,前往主控台中的「API 控制台」頁面,該頁麵包含與指令碼相關聯的專案。如果專案尚未選取,請從「Project」下拉式清單中選取專案。在搜尋列中輸入 API 名稱,即可搜尋要在指令碼中使用的 API。

在搜尋結果中選取 API,然後在下一頁選擇「啟用」;如果系統顯示「Disable」按鈕,表示這個 API 已啟用。針對要啟用的每個 API,重複此操作。

如要查看專案已啟用的 API 清單,請選取「Dashboard」(資訊主頁) 頁面。確認清單中已列出您要用於指令碼的所有 Advanced API。

現在關閉「Advanced API」對話方塊,返回編輯器。系統會為您的指令碼啟用新的 API,並顯示在自動完成清單中。

可用的 API

下列 API 可供使用:

API 名稱 說明文件
Google Analytics (分析) https://developers.google.com/apps-script/advanced/analytics
Google BigQuery https://developers.google.com/apps-script/advanced/bigquery
Google 日曆 https://developers.google.com/apps-script/advanced/calendar
Google 簡報 https://developers.google.com/apps-script/advanced/slides
Google Tasks https://developers.google.com/apps-script/advanced/tasks
購物內容 https://developers.google.com/apps-script/advanced/shopping-content
YouTube https://developers.google.com/apps-script/advanced/youtube
YouTube 數據分析 https://developers.google.com/apps-script/advanced/youtube-analytics

有關如何使用這些 API 的範例,您也可以參閱程式碼片段頁面

最後注意事項

使用 Advanced API 時,請留意以下事項。

專案 ID

每個 Google Ads 指令碼都有相關聯的 Google Cloud Platform 專案 ID (又稱為專案編號)。在「進階 API」對話方塊中開啟 Google API 控制台頁面,即可找到指令碼的專案編號。這個專案 ID 會在您建立指令碼時建立,且與建立 Google Ads 指令碼的使用者相關聯。如果之後從帳戶中移除建立指令碼的使用者,系統就會提示嘗試存取指令碼的使用者重新授權指令碼,並再次設定 Advanced API 依附元件。系統也會建立新的 Google 開發人員專案 ID,屆時您必須重新設定進階 API,如本文件先前所述。

依附元件

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

權限

存取 API 時,指令碼會使用授權指令碼使用者的權限。確認授權指令碼的使用者俱備必要存取權,可以存取使用的所有 Advanced API,以及指令碼所需的資料。如果您使用的是 Google Analytics (分析) API,請確認授權指令碼的使用者俱備存取 Analytics (分析) 帳戶的必要權限。

條款及細則

每個 Advanced API 都有各自的條款及細則,您在 Google API 控制台中啟用 API 時,請務必接受這些條款及細則。

配額

大部分的 Advanced API 都有相關聯的每日免費配額。一旦指令碼超出此配額,API 就會停止運作,直到您要求更多資料,或是免費配額獲得補充為止。您可以在「進階 API」對話方塊中開啟指令碼的 Google API 控制台,藉此監控指令碼使用的配額。Google API 控制台也提供另一種 API 配額的申請方式。

帳單

部分 Advanced API 需要付費才能使用。這些款項是透過與指令碼相關聯的 Google Cloud Platform 專案進行管理,而非透過 Google Ads。如要進一步瞭解如何啟用指令碼的 Google Cloud Platform 專案計費功能,請參閱說明文件