Proxy

  • You can connect to the Google Ads API through a proxy by setting the http_proxy configuration in your google-ads.yaml file.

  • The http_proxy setting in google-ads.yaml supports specifying a proxy with or without username and password.

  • Alternatively, you can configure the proxy setting programmatically using GoogleAdsClient methods like load_from_dict, load_from_env, and load_from_string.

  • To use a proxy with the load_from_env method, set the GOOGLE_ADS_HTTP_PROXY environment variable.

If you need to connect to the Google Ads API through a proxy, you can do so by setting the http_proxy config in your google-ads.yaml file:

# Proxy configuration
###############################################################################
# Below you can specify an optional proxy configuration to be used by         #
# requests. If you don't have username and password, just specify host and    #
# port.                                                                       #
# #############################################################################
http_proxy: INSERT_PROXY_HERE

For example, you can specify http://user:pass@localhost:8082 as a proxy. Alternatively, you can configure the proxy setting programmatically using the GoogleAdsClient methods: load_from_dict, load_from_env, and load_from_string, just like any other configuration setting. For example:

config = {
  ...
  "http_proxy": "INSERT_PROXY_HERE",
}
googleads_client = GoogleAdsClient.load_from_dict(config)

To use a proxy with the load_from_env method, set the GOOGLE_ADS_HTTP_PROXY environment variable.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-03-25 UTC.