以下檢查清單可協助您著手進行遷移作業:
查看 AdWords API 和 Google Ads API 的對應表:
請查看下列工具:
接受新版《條款及細則》,並更新 API 中心的聯絡資訊。
- 登入您擁有開發人員權杖的管理員帳戶 API 中心:
ads.google.com/aw/apicenter
。 - 向下捲動至「API 聯絡電子郵件地址」並更新電子郵件地址。
- 向下捲動至「主要商家地點」並接受新條件,然後按一下「儲存」。
- 登入您擁有開發人員權杖的管理員帳戶 API 中心:
在 Google Cloud 專案中啟用 Google Ads API。
- 在 Google API 控制台中開啟 API 程式庫。按照系統說明選取專案,或建立新專案。 API 程式庫會列出所有可用的 API,並依產品系列和熱門程度分組。
- 如果 Google Ads API 在清單中未顯示,請使用搜尋功能找出。
- 選取「Google Ads API」,然後點選「啟用」按鈕。
如果您已經使用 AdWords API,您使用的憑證在 Google Ads API 中仍然有效。請勿要求新的開發人員權杖或建立新的 OAuth2
clientId
和clientSecret
組合。選取用戶端程式庫。
按照快速入門指南進行首次呼叫。
使用用戶端程式庫
如果您使用的是其中一個 AdWords API 用戶端程式庫,可以下載其中一個 Google Ads API 用戶端程式庫,立即開始運作。如需設定設定檔的操作說明,請參閱用戶端程式庫的 README。
在大部分情況下,從 AdWords API 用戶端程式庫遷移至 Google Ads API 用戶端程式庫時,即可重複使用現有的設定。其中一項主要差異是新的 login-customer-id
。本指南說明何時需要在設定中加入此項目。
Java 設定範例
針對 Java 用戶端程式庫,您可以直接複製 ads.properties
檔案中指定憑證的行,然後將每個金鑰中的 api.adwords
前置字串變更為 api.googleads
:
api.adwords.clientId --> api.googleads.clientId
api.adwords.clientSecret --> api.googleads.clientSecret
api.adwords.refreshToken --> api.googleads.refreshToken
api.adwords.developerToken --> api.googleads.developerToken
更新設定檔後,您就可以繼續進行第一次呼叫:
Java
- 在 IDE 中開啟 GetCampaigns.java 並執行。
- 這個控制台應會顯示您帳戶中的廣告活動清單。
C#
- 在 IDE 中開啟 GetCampaigns.cs 並執行。
- 這個控制台應會顯示您帳戶中的廣告活動清單。
PHP
- 執行 GetCampaigns.php。
- 這個控制台應會顯示您帳戶中的廣告活動清單。
Python
- 在 IDE 中開啟 get_campaigns.py 並執行。
- 這個控制台應會顯示您帳戶中的廣告活動清單。
Ruby
- 在指令列中輸入:
ruby get_campaigns.rb
,以執行 get_campaigns.rb: - 這個控制台應會顯示您帳戶中的廣告活動清單。
Perl
- 執行 get_campaigns.pl。
- 這個控制台應會顯示您帳戶中的廣告活動清單。
程式碼範例
用戶端程式庫也提供逐步程式碼範例,說明如何從 AdWords API 遷移至 Google Ads API。
使用用戶端程式庫的替代方案
若您在沒有用戶端程式庫的情況下使用 AdWords API,且想要繼續使用 Google Ads API,還是可以使用憑證。
請參閱 REST 指南,瞭解如何在 Google Ads API 上使用憑證,透過 HTTP 使用 REST 執行要求。