التهيئة

توفّر مكتبة عملاء 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({
  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 للخادم الوكيل المستخدَم للاتصال بالإنترنت