超时

Ruby 客户端库中的每项服务都附带默认超时和重试政策,这些政策在该服务的 client.rb 文件中指定。例如,您可以检查 CampaignService 客户端配置中的 self.configure 方法。

替换默认超时时间

您可以在实例化服务实例后替换这些默认值,方法是设置服务级 config.timeout(以秒为单位),或为 config.rpcs 上的各个 RPC 方法配置 timeout 和 retry_policy:

require 'google/ads/google_ads'

client = Google::Ads::GoogleAds::GoogleAdsClient.new
ga_service = client.service.google_ads

ga_service.configure do |config|
  # Set the default timeout (in seconds) for all RPCs on this service instance.
  config.timeout = 120.0

  # Override the timeout or retry policy for specific RPC methods.
  config.rpcs.search_stream.timeout = 300.0
  config.rpcs.search.timeout = 120.0
  config.rpcs.search.retry_policy = {
    'initial_delay' => 5.0,
    'max_delay' => 60.0
  }
end

如需查看完整的可运行脚本,请参阅 GitHub 上的 set_custom_client_timeouts.rb 代码示例。

超时限制和错误

虽然您可以增加客户端超时时长,但服务器端限制仍然适用。耗时超过两小时的请求可能会失败,并引发 Google::Ads::GoogleAds::Errors::GoogleAdsError 或 GRPC::DeadlineExceeded 异常,状态为 DEADLINE_EXCEEDED。