基本用法

客户端库的基本用法如下:

安装

建议使用 bundler 进行安装。将一行添加到 Gemfile(将 x.y.z 替换为您感兴趣的版本号):

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

然后运行以下命令:

$ bundle install

此命令使用 bundler 更新 Gemfile.lock,锁定到已安装的 gem 的确切版本以及 gem 的所有依赖项。悲观版本运算符 "~> x.y.z" 会导致 bundle update 仅安装 新版本在 x.y.* 系列中,因此您必须通过再次更新您的 Gemfile 手动选择新版本。

其他安装选项

如果您未使用 bundler,则可以使用以下选项之一:

  1. 使用 gem 安装此库: terminal $ [sudo] gem install google-ads-googleads
  2. 从 “版本”页面下载 gem,然后从本地文件安装: terminal $ [sudo] gem install google-ads-googleads-[version].gem

设置身份验证

如需对 API 调用进行身份验证,请按照 身份验证和授权页面上的说明操作。

用法

如需在代码中添加 gem,请执行以下操作:

require 'google/ads/google_ads'

如需提取特定服务(例如 CampaignService),请执行以下操作:

client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign

如需详细了解如何使用该库,请参阅 GitHub 上的示例

熟悉这些示例后,我们还建议您熟悉 工厂,它提供了一组用于处理 Google Ads API 的高级便利方法。

错误处理

并非每个 API 调用都会成功。如果 API 调用因某种原因失败,服务器可能会抛出错误。捕获 API 错误并对其进行适当处理非常重要。

发生 API 错误时,系统会抛出 GoogleAdsException 实例。它包含有助于您找出问题所在的详细信息,您可以设置一个帮助程序函数来处理错误。如需查看 错误处理程序的示例,请参阅 GitHub