پیکربندی پروکسی

کتابخانه کلاینت جاوای Google Ads API از gRPC برای انتقال استفاده می‌کند و از تنظیمات پروکسی استاندارد سیستم جاوا برای اتصال به API پشتیبانی می‌کند.

تنظیمات

این کتابخانه از ویژگی‌های استاندارد شبکه و پروکسی برای جاوا پشتیبانی می‌کند.

پیکربندی خط فرمان

برای یک پروکسی 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"