الإعدادات

وتتم عملية الضبط باستخدام فئة Config. يمكنك الوصول إلى هذا الفئة بعدة طرق، مثل كتابة ملف إعداد أو تحديد القيم عند الإنشاء أو تحميل القيم من متغيرات البيئة.

ملف الإعداد

يمكنك تحديد ملف google_ads_config.rb لاستخدامه عند إنشاء مثيل العميل.

إذا لم تستخدم أي وسيطات عند إنشاء مثيل:

client = Google::Ads::GoogleAds::GoogleAdsClient.new

بعد ذلك، ستظهر المكتبة في الموقع الجغرافي المحدّد في متغير بيئة GOOGLE_ADS_CONFIGURATION_FILE_PATH. في حال عدم ضبط المتغيّر، ستظهر المكتبة في دليل HOME بحثًا عن الملف.

بدلاً من ذلك، يمكنك تحديد مسار:

client = Google::Ads::GoogleAds::GoogleAdsClient.new("path/to/file.rb")

وفي هذه الحالة سيبحث العميل عن الملف في مسار الملف هذا.

إنّ أسهل طريقة لإنشاء هذا الملف هي نسخ google_ads_config.rb من مستودع GitHub وتعديله لتضمين الرمز المميّز لإعادة التحميل ومعرّف العميل وسر العميل.

الإعداد الديناميكي

يمكنك إعداد الضبط ديناميكيًا عند إنشاء مثيل للمكتبة، أو حتى بعد ذلك:

client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
  config.client_id = 'INSERT_CLIENT_ID_HERE'
  # ... more configuration
end

يمكنك أيضًا تعديل الإعدادات بعد إنشاء مثيل:

client.configure do |config|
  config.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
  # ... more configuration
end

حقول الإعداد

يتيح الكائن Config الحقول التالية:

الحقول العامة:

  • refresh_token: الرمز المميز لتحديث بروتوكول OAuth.
  • client_id: معرِّف عميل OAuth.
  • client_secret: سر عميل OAuth.
  • developer_token: الرمز المميز للمطوِّر للدخول إلى واجهة برمجة التطبيقات.
  • login_customer_id: اطّلِع على مستنداتlogin-customer-id.

حقول التسجيل راجع دليل التسجيل للحصول على التفاصيل الكاملة.

  • log_level: الحد الأدنى للرسائل على مستوى السجلّ التي تريد تسجيلها. على سبيل المثال، سيضمن تحديد 'DEBUG' عرض جميع رسائل السجلّ، كما سيؤدي تحديد 'INFO' إلى استبعاد رسائل DEBUG وعرض جميع الرسائل الأخرى.
  • log_target: المكان الذي تريد تسجيل الدخول إليه، مثل STDERR
  • logger: تحديد المسجِّل المخصّص الخاص بك سيؤدي تحديد ذلك إلى إلغاء كل من log_level وlog_target.

متغيرات البيئة

يمكنك ضبط مكتبة العملاء باستخدام متغيرات البيئة. ولا يتم تحميلها افتراضيًا وتتطلب استدعاءًا إضافيًا بعد إنشاء مثيل العميل من أجل التحميل. اطّلِع على القائمة الكاملة لمتغيرات البيئة المتوافقة مع جميع اللغات.

لتحميل متغيرات البيئة في Config، استدعِ load_environment_config:

client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.load_environment_config

عند استدعاء هذه الدالة، ستستبدل الحالة الحالية لمتغيرات البيئة أي عناصر متوفّرة حاليًا في Config. وباستخدام هذه الآلية، يمكنك مثلاً ضبط إعدادات تلقائية مع تجاوز قيم معيّنة باستخدام متغيرات بيئة، أو يمكنك ضبط الإعدادات بالكامل باستخدام متغيرات بيئية.

بالإضافة إلى متغيرات البيئة التي تدعمها جميع المكتبات، فإن لمكتبة Ruby متغيران إضافيان:

  • GOOGLE_ADS_RUBY_LOG_LEVEL: مثل log_level أعلاه.
  • GOOGLE_ADS_RUBY_HTTP_PROXY: حدِّد خادم وكيل HTTP.