الإعدادات

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