الإعدادات

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