پیکربندی

کتابخانه 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 شما.

فیلدهای موجود در API Client :

• developer_token : توکن توسعه دهنده شما برای دسترسی به API.
• login_customer_id : مستندات login-customer-id را ببینید.
• proxy : URL سرور پروکسی که برای اتصال به اینترنت استفاده می شود.