التهيئة

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

ملف الإعداد

يمكنك تحديد ملف 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({
  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");

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

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

يوفّر وحدة 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.

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

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