프록시 구성

Google Ads API Java 클라이언트 라이브러리는 전송에 gRPC를 사용하며 API에 연결하기 위한 표준 Java 시스템 프록시 설정을 지원합니다.

설정

이 라이브러리는 Java의 표준 네트워킹 및 프록시 속성을 지원합니다.

명령줄 구성

HTTPS 프록시의 경우 애플리케이션 시작 시 다음 JVM 인수를 전달합니다.

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

HTTP 프록시 (자체 로컬 HTTP 프록시 엔드포인트를 제공하지 않는 한 권장되지 않음)의 경우 프록시 구성을 다음과 같이 설정합니다.

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

프로그래매틱 구성

서비스 클라이언트를 만들기 전에 런타임에 프로그래매틱 방식으로 HTTP 및 HTTPS 프록시 속성을 구성할 수도 있습니다.

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

참고: 시스템 속성은 전역 JVM 상태를 수정합니다. gRPC 채널은 생성 시 전송 설정을 캐시하므로 런타임에 이러한 속성을 변경하는 경우 기존 서비스 클라이언트를 다시 만들어야 합니다 (예: googleAdsClient.getLatestVersion().createGoogleAdsServiceClient() 호출).

프록시 인증 및 우회

프록시 서버에 인증 또는 호스트 제외가 필요한 경우 추가 JVM 프록시 속성을 지정합니다.

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