التهيئة

توفّر مكتبة برامج 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: اطّلِع على مستندات تسجيل الدخول للعميل
  • proxy: عنوان URL للخادم الوكيل المستخدَم للاتصال بالإنترنت.