Configuração do proxy

A biblioteca de cliente para Java da API Google Ads usa o gRPC para transporte e é compatível com as configurações de proxy do sistema Java padrão para se conectar à API.

Configurações

A biblioteca é compatível com as propriedades padrão de rede e proxy para Java.

Configuração da linha de comando

Para um proxy HTTPS, transmita os seguintes argumentos da JVM na inicialização do aplicativo:

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

Para um proxy HTTP (não recomendado, a menos que você esteja fornecendo seu próprio endpoint de proxy HTTP local), defina a configuração do proxy como:

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

Configuração programática

Também é possível configurar as propriedades de proxy HTTP e HTTPS de maneira programática no ambiente de execução antes de criar os clientes de serviço:

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

Observação: as propriedades do sistema modificam o estado global da JVM. Como os canais gRPC armazenam em cache as configurações de transporte no momento da criação, se você alterar essas propriedades no ambiente de execução, será necessário recriar todos os clientes de serviço existentes (por exemplo, chamando googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()).

Autenticação e desvio de proxy

Se o servidor proxy exigir autenticação ou exclusões de host, especifique as propriedades de proxy adicionais da JVM:

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