Proxykonfiguration

Die Google Ads API-Clientbibliothek für Java verwendet gRPC für den Transport und unterstützt standardmäßige Java-Systemproxyeinstellungen für die Verbindung zur API.

Einstellungen

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

Befehlszeilenkonfiguration

Übergeben Sie für einen HTTPS-Proxy beim Starten 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 Proxykonfiguration 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 alle vorhandenen Dienstclients neu erstellen, wenn Sie diese Eigenschaften zur Laufzeit ändern (z. B. durch Aufrufen von googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()).

Proxy-Authentifizierung und ‑Umgehung

Wenn für Ihren Proxyserver eine Authentifizierung oder Host-Ausschlüsse erforderlich sind, geben Sie die zusätzlichen JVM-Proxy-Properties an:

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