التهيئة

توفّر مكتبة عميل 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 من مستودع GitHub وتعديله ليشمل معرّف العميل وسر العميل والرمز المميز لإعادة التحميل.

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

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

my $api_client = Google::Ads::GoogleAds::Client->new({
  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");

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

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

يوفّر وحدة Client النمطية الدالة 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.

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

• login_customer_id: يمكنك الاطّلاع على مستندات login-customer-id.
• proxy: عنوان URL للخادم الوكيل المستخدَم للاتصال بالإنترنت.