基本用法

用戶端程式庫的基本用法如下：

安裝

建議使用 Bundler 安裝程式庫。在 Gemfile 中新增一行 (將 x.y.z 替換為要使用的版本號碼)：

gem 'google-ads-googleads', '~> x.y.z'

接著執行下列指令：

bundle install

這個指令會使用 Bundler 更新 Gemfile.lock，鎖定 Gem 的確切版本，以及已安裝 Gem 的所有依附元件。悲觀版本運算子 "~> x.y.z" 可確保 bundle install 或 bundle update 只會安裝 x.y.* 系列中的新修補程式版本，因此您必須更新 Gemfile，手動選擇新的次要或主要版本。

其他安裝選項

如果您未使用 Bundler，可以採用下列其中一種做法：

  1. 使用 RubyGems 安裝這個程式庫：

    gem install google-ads-googleads

  2. 從版本頁面下載 Gem，並從本機檔案安裝：

    gem install google-ads-googleads-[version].gem

設定驗證方法

如要驗證 API 呼叫，請設定 google_ads_config.rb 檔案，並按照「驗證與授權」頁面的操作說明進行。

用量

從 google-ads-googleads v41.1.0 開始，Gem 支援 Bundler 自動要求 (Bundler.require)。在 v41.1.0 之前的版本 (或不使用 Bundler.require 時)，請在程式碼中明確要求 Gem：

require 'google/ads/google_ads'

初始化用戶端 (預設會從 ~/google_ads_config.rb 載入設定)，並擷取特定服務，例如 CampaignService：

# Initialize the client using ~/google_ads_config.rb.
client = Google::Ads::GoogleAds::GoogleAdsClient.new

# Fetch the CampaignService client.
campaign_service = client.service.campaign

如要進一步瞭解如何使用程式庫，請參閱 GitHub 上的範例。

熟悉範例後，請探索工廠，其中提供一組高階便利方法，可用於處理 Google Ads API。

錯誤處理

並非所有 API 呼叫都會成功。如果 API 呼叫失敗，伺服器會引發例外狀況。請務必擷取 API 錯誤並妥善處理。

發生 API 錯誤時，系統會引發 Google::Ads::GoogleAds::Errors::GoogleAdsError 例項。其中包含詳細資料，可協助您判斷問題所在，您也可以設定輔助函式來處理錯誤。請參閱 GitHub 上的錯誤處理常式範例。