遷移檢查清單

影片庫:2021 年研討會

以下這份檢查清單可協助您開始執行遷移作業:

  1. 查看 AdWords API 與 Google Ads API 之間的對應關係:

  2. 歡迎查看以下工具:

  3. 接受更新的條款及細則,並在 API 中心更新您的聯絡資訊。

    • 登入您擁有開發人員權杖的管理員帳戶 API 中心ads.google.com/aw/apicenter
    • 向下捲動到「API 聯絡人電子郵件」,然後進行更新。
    • 向下捲動至「主要營業地點」,接受新條件,然後按一下 [儲存]
  4. 在 Google Cloud 專案中啟用 Google Ads API。

    • 在 Google API 控制台中開啟 API 程式庫。如果出現系統提示,請選取您的專案或建立新專案。API 程式庫會列出所有可用 API,並依照產品系列和熱門程度分組。
    • 如果清單上沒有顯示 Google Ads API,請使用搜尋功能找出該 ID。
    • 選取 [Google Ads API],然後按一下 [啟用] 按鈕。
  5. 如果您已經在使用 AdWords API,則您使用的憑證仍然有效,可以用於 Google Ads API。請勿索取新的開發人員權杖,或是建立新的 OAuth2 clientIdclientSecret 配對。

  6. 選取用戶端程式庫。

  7. 按照快速入門導覽課程指南完成第一次呼叫

使用用戶端程式庫

如果您使用的是其中一個 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

  1. 在 IDE 中開啟 GetCampaigns.java 並執行。
  2. 控制台應該會列出您帳戶中的廣告活動清單。

C#

  1. 在 IDE 中開啟 GetCampaigns.cs 並執行。
  2. 控制台應該會列出您帳戶中的廣告活動清單。

PHP

  1. 執行 GetCampaigns.php
  2. 控制台應該會列出您帳戶中的廣告活動清單。

Python

  1. 在 IDE 中開啟 get_campaigns.py 並執行。
  2. 控制台應該會列出您帳戶中的廣告活動清單。

Ruby

  1. 在指令列上執行 get_campaigns.rb,輸入:
    ruby get_campaigns.rb
  2. 控制台應該會列出您帳戶中的廣告活動清單。

Perl

  1. 執行 get_campaigns.pl
  2. 控制台應該會列出您帳戶中的廣告活動清單。

程式碼範例

用戶端程式庫也會提供從 AdWords API 遷移至 Google Ads API 的逐步程式碼範例。

Java

遷移範例

C#

遷移範例

PHP

遷移範例

Python

遷移範例

Ruby

遷移範例

Perl

遷移範例

使用用戶端程式庫的替代方案

若您在沒有用戶端程式庫的情況下使用 AdWords API,且想要繼續使用 Google Ads API,您還是可以繼續使用憑證。

請參閱 REST 指南,瞭解如何透過憑證使用 HTTP,透過 HTTP 對 Google Ads API 執行請求。