إعداد الخادم الوكيل

إذا كنت بحاجة إلى الاتصال بواجهة برمجة التطبيقات Google Ads API من خلال وكيل HTTP أو HTTPS، يمكنك ضبط الإعداد http_proxy في ملف الإعداد أو برمجيًا أو من خلال متغيّر بيئة. ينطبق الإعداد http_proxy على قناة النقل الأساسية لـ gRPC التي تستخدمها مكتبة برامج Python.

الضبط باستخدام google-ads.yaml

حدِّد الإعداد http_proxy في ملف google-ads.yaml:

# Optional proxy configuration used for API requests. If your proxy does not
# require authentication, specify only the host and port.
http_proxy: INSERT_PROXY_HERE

على سبيل المثال، يمكنك تحديد http://user:pass@localhost:8082 كخادم وكيل.

تنبيه: تجنَّب إرسال بيانات اعتماد الخادم الوكيل بالنص العادي إلى نظام التحكم في الإصدارات. استخدِم متغيرات البيئة لبيانات اعتماد الخادم الوكيل الحسّاسة في بيئات الإنتاج.

ضبط الإعدادات آليًا

يمكنك أيضًا ضبط إعدادات الخادم الوكيل آليًا باستخدام طرق تهيئة GoogleAdsClient (load_from_dict وload_from_env وload_from_string)، تمامًا مثل أي إعدادات ضبط أخرى:

from google.ads.googleads.client import GoogleAdsClient

config = {
    # Include other required configuration settings here.
    "http_proxy": "INSERT_PROXY_HERE",
}
googleads_client = GoogleAdsClient.load_from_dict(config)

الضبط باستخدام متغيرات البيئة

لضبط خادم وكيل باستخدام الطريقة load_from_env، اضبط متغيّر البيئة GOOGLE_ADS_HTTP_PROXY على النحو التالي:

export GOOGLE_ADS_HTTP_PROXY="http://user:pass@localhost:8082"