الإعدادات

توفِّر مكتبة برامج Ads API العديد من إعدادات الضبط التي يمكنك استخدامها لتخصيص سلوك المكتبة.

ملف الإعداد

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

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

my $api_client = Google::Ads::GoogleAds::Client->new();

فعندئذٍ ستبحث المكتبة في دليل HOME عن الملف.

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

my $properties_file = "/path/to/googleads.properties";

my $api_client = Google::Ads::GoogleAds::Client->new({
  properties_file => $properties_file
});

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

أسهل طريقة لإنشاء هذا الملف هي نسخ googleads.properties من مستودع جيت هب وتعديله لتضمين معرّف العميل وسر العميل والرمز المميز للتحديث.

الضبط الديناميكي

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

my $api_client = Google::Ads::GoogleAds::Client->new({
  developer_token   => "INSERT_DEVELOPER_TOKEN_HERE",
  login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});

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

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

يمكنك أيضًا الحصول على كائن OAuth2ApplicationsHandler من خلال API Client، وتغيير معرّف العميل وسر العميل والرمز المميز للتحديث في وقت التشغيل:

my $oauth2_applications_handler = $api_client->get_oauth2_applications_handler();
$oauth2_applications_handler->set_client_id("INSERT_CLIENT_ID");
$oauth2_applications_handler->set_client_secret("INSERT_CLIENT_SECRET");
$oauth2_applications_handler->set_refresh_token("INSERT_REFRESH_TOKEN");

متغيرات بيئة الإعداد

يمكنك ضبط بعض إعدادات الضبط من متغيرات البيئة عند إجراء نسخ افتراضية للبرامج (اطّلِع على القائمة الشاملة).

توفر وحدة العميل الدالة configure_from_environment_variables لتحميل قيم من متغيرات البيئة:

ملاحظة: لا يتم أخذ متغيرات البيئة غير المحدَّدة في الاعتبار.

# Get the Google Ads Client. By default, any credentials will be read from
# ~/googleads.properties, or, if set, from the file specified in the
# GOOGLE_ADS_CONFIGURATION_FILE_PATH environment variable.
my $api_client = Google::Ads::GoogleAds::Client->new();

# Load the configuration from any set environment variables.
$api_client->configure_from_environment_variables();

حقول الضبط

تتوافق خصائص الضبط مع الحقول التالية:

تستمر الحقول في OAuth2ApplicationsHandler:

• client_id: معرِّف عميل OAuth2.
• client_secret: سر عميل OAuth2.
• refresh_token: الرمز المميّز لإعادة تحميل OAuth2

لا تزال الحقول متوفّرة في عميل واجهة برمجة التطبيقات:

• developer_token: الرمز المميز للمطوِّر للدخول إلى واجهة برمجة التطبيقات.
• login_customer_id: اطّلِع على مستنداتlogin-customer-id.
• proxy: عنوان URL للخادم الوكيل المُستخدَم في الاتصال بالإنترنت