Proxykonfiguration

Die Java-Clientbibliothek der Google Ads API verwendet gRPC für die Übertragung und unterstützt die standardmäßigen Java-System-Proxy-Einstellungen für die Verbindung mit der API.

Einstellungen

Die Bibliothek unterstützt die Standardnetzwerk- und Proxy-Attribute für Java.

Befehlszeilenkonfiguration

Übergeben Sie für einen HTTPS-Proxy beim Start der Anwendung die folgenden JVM-Argumente:

-Dhttps.proxyHost=HOST -Dhttps.proxyPort=PORT

Für einen HTTP-Proxy (nicht empfohlen, es sei denn, Sie stellen Ihren eigenen lokalen HTTP-Proxy-Endpunkt bereit) legen Sie die Proxy-Konfiguration so fest:

-Dhttp.proxyHost=HOST -Dhttp.proxyPort=PORT

Programmatische Konfiguration

Sie können HTTP- und HTTPS-Proxy-Eigenschaften auch programmatisch zur Laufzeit konfigurieren, bevor Sie Ihre Dienstclients erstellen:

System.setProperty("https.proxyHost", "HOST");
System.setProperty("https.proxyPort", "PORT");

Hinweis: Systemeigenschaften ändern den globalen JVM-Status. Da gRPC-Kanäle die Transporteinstellungen bei der Erstellung im Cache speichern, müssen Sie bei einer Änderung dieser Attribute zur Laufzeit alle vorhandenen Dienstclients neu erstellen (z. B. durch Aufrufen von googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()).

Proxy-Authentifizierung und -Umgehung

Wenn Ihr Proxyserver eine Authentifizierung oder Hostausschlüsse erfordert, geben Sie die zusätzlichen JVM-Proxy-Properties an:

-Dhttps.proxyUser=USERNAME \
-Dhttps.proxyPassword=PASSWORD \
-Dhttp.nonProxyHosts="localhost|127.0.0.1"