Proxy configuration
Stay organized with collections
Save and categorize content based on your preferences.
The Java client library supports proxy settings for connecting to the API.
Settings
The library supports using the
standard proxy settings for Java.
For HTTPS proxy set the proxy configuration as:
-Dhttps.proxyHost=HOST -Dhttps.proxyPort=PORT
For HTTP proxy (not recommended unless you're providing your own HTTP endpoint),
set the proxy configuration as:
-Dhttp.proxyHost=HOST -Dhttp.proxyPort=PORT
It is possible to configure both HTTP and HTTPS proxy at runtime.
System.setProperty("https.proxyHost", HOST);
System.setProperty("https.proxyPort", PORT);
If you change this setting then you must recreate any service clients provided
by GoogleAdsClient.getVersionX().createYServiceClient().
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 2025-08-20 UTC.
[null,null,["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThe Java client library enables connections to the API through proxy settings, utilizing standard Java proxy configurations.\u003c/p\u003e\n"],["\u003cp\u003eFor HTTPS proxy connections, use \u003ccode\u003e-Dhttps.proxyHost=HOST -Dhttps.proxyPort=PORT\u003c/code\u003e, while HTTP proxy (less secure) uses \u003ccode\u003e-Dhttp.proxyHost=HOST -Dhttp.proxyPort=PORT\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eBoth HTTP and HTTPS proxy settings can be dynamically configured at runtime using \u003ccode\u003eSystem.setProperty()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAny changes to the proxy settings require recreating service clients via \u003ccode\u003eGoogleAdsClient.getVersionX().createYServiceClient()\u003c/code\u003e to apply the new configuration.\u003c/p\u003e\n"]]],[],null,["# Proxy configuration\n\nThe Java client library supports proxy settings for connecting to the API.\n\nSettings\n--------\n\nThe library supports using the\n[standard proxy settings for Java](//docs.oracle.com/en/java/javase/12/docs/api/java.base/java/net/doc-files/net-properties.html).\n\nFor HTTPS proxy set the proxy configuration as: \n\n -Dhttps.proxyHost=HOST -Dhttps.proxyPort=PORT\n\nFor HTTP proxy (not recommended unless you're providing your own HTTP endpoint),\nset the proxy configuration as: \n\n -Dhttp.proxyHost=HOST -Dhttp.proxyPort=PORT\n\nIt is possible to configure both HTTP and HTTPS proxy at runtime. \n\n System.setProperty(\"https.proxyHost\", HOST);\n System.setProperty(\"https.proxyPort\", PORT);\n\nIf you change this setting then you must recreate any service clients provided\nby `GoogleAdsClient.getVersionX().createYServiceClient()`."]]
