Configuração do proxy

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

Configurações

A biblioteca oferece suporte às 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 propriedades de proxy HTTP e HTTPS de forma programática em tempo 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ê mudar essas propriedades durante a execução, será necessário recriar todos os clientes de serviço atuais (por exemplo, chamando googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()).

Autenticação e bypass de proxy

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

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