Google Ads API Explorer

Google Ads API Explorer 是一種互動式執行環境，可讓您直接在瀏覽器中建構及傳送即時 API 要求。這項工具內建於參考說明文件中，可處理 OAuth 2.0 驗證和 JSON 酬載格式的複雜性，讓您測試特定服務和方法，不必撰寫任何程式碼。

優點

  • 無程式碼測試：直接從說明文件執行即時 API 呼叫 (讀取和寫入)，不必設定本機開發環境。
  • 通訊協定探索：查看 HTTP 要求和回應的確切結構，瞭解 API 的運作方式。
  • 低摩擦原型設計：在應用程式中導入邏輯前，請先驗證端點行為，並立即檢查原始 API 回應。
  • 簡化驗證程序：這項工具會自動管理 OAuth 2.0 流程，讓您專注於 API 請求，不必費心管理憑證。

開始使用

  1. 前往說明文件：前往參考說明文件，然後選取要測試的服務和方法，例如 GoogleAdsService/Search。
  2. 開啟 Explorer：在頁面右側尋找「Try it!」面板。
  3. 設定要求：
    • 輸入必要的要求參數，例如 developer-token 和 login-customer-id。
    • 如果方法需要酬載 (例如 `mutate` 作業)，請使用互動式 JSON 編輯器定義要求主體。
  4. 執行：按一下「執行」傳送要求。這項工具會顯示完整的 HTTP 要求，以及 API 傳回的即時 JSON 回應。

主要功能與特色

  • 即時執行：對正式或測試帳戶執行即時 search 和 mutate 作業。
  • JSON 酬載格式：互動式建構要求用的複雜 JSON 物件，工具會醒目顯示必要欄位和有效結構定義結構。
  • 欄位遮罩：測試 update_mask 邏輯，瞭解部分資源更新在實際情況中的行為。
  • 檢查錯誤：查看原始回應中的詳細錯誤訊息和代碼 (例如 QUERY_ERROR 或 AUTHENTICATION_ERROR)，加快偵錯速度。
  • 匯出程式碼：從 API Explorer 的展開檢視畫面匯出 curl 指令、原始 HTTP 要求或 JavaScript 程式碼範例。

應用實例

  • 稽核帳戶設定：執行 get 或 search 要求，即可快速擷取帳戶層級的設定或中繼資料。
  • 測試變動：在將程式碼部署至正式環境前，請先確認廣告活動建立或預算更新是否成功。
  • 偵錯 GAQL：使用探索工具執行 Google Ads 查詢語言 (GAQL) 字串，並確認傳回的 JSON 結構符合應用程式的預期。
  • 通訊協定驗證：檢查特定 API 版本所需的確切 HTTP 標頭和 JSON 巢狀結構。