Thư viện Ứng dụng API Google Ads cung cấp một số chế độ cài đặt cấu hình mà bạn có thể dùng để tuỳ chỉnh hoạt động của thư viện.
Tệp cấu hình
Bạn có thể chỉ định một tệp googleads.properties
để sử dụng khi tạo thực thể ứng dụng.
Nếu bạn không sử dụng đối số khi tạo thực thể:
my $api_client = Google::Ads::GoogleAds::Client->new();
thì thư viện sẽ tìm tệp trong thư mục HOME
của bạn.
Ngoài ra, bạn có thể chỉ định một đường dẫn:
my $properties_file = "/path/to/googleads.properties";
my $api_client = Google::Ads::GoogleAds::Client->new({
properties_file => $properties_file
});
trong trường hợp đó, ứng dụng sẽ tìm tệp tại đường dẫn tệp đó.
Cách dễ nhất để tạo tệp này là sao chép googleads.properties
từ kho lưu trữ GitHub và sửa đổi để bao gồm ID ứng dụng khách, mật khẩu ứng dụng khách và mã làm mới.
Cấu hình động
Bạn có thể thiết lập cấu hình một cách linh động khi tạo thực thể cho thư viện hoặc ngay cả sau đó:
my $api_client = Google::Ads::GoogleAds::Client->new({
developer_token => "INSERT_DEVELOPER_TOKEN_HERE",
login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});
Bạn thậm chí có thể sửa đổi cấu hình sau khi tạo bản sao:
$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");
Bạn cũng có thể nhận đối tượng OAuth2ApplicationsHandler từ API Client
và thay đổi mã ứng dụng khách, mật khẩu ứng dụng khách và mã làm mới trong thời gian chạy:
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");
Biến môi trường định cấu hình
Bạn có thể đặt một số chế độ cài đặt cấu hình từ các biến môi trường khi tạo thực thể ứng dụng (xem danh sách đầy đủ).
Mô-đun ứng dụng cung cấp hàm configure_from_environment_variables
để tải các giá trị từ biến môi trường:
# 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();
Trường cấu hình
Thuộc tính cấu hình hỗ trợ các trường sau:
Các trường được lưu giữ trong OAuth2ApplicationsHandler:
client_id
: Mã ứng dụng khách OAuth2 của bạn.client_secret
: Mật khẩu ứng dụng khách OAuth2 của bạn.refresh_token
: Mã làm mới OAuth2 của bạn.
Các trường được lưu giữ trong Ứng dụng API:
developer_token
: Mã của nhà phát triển để truy cập API.login_customer_id
: Xem tài liệu về đăng nhập-khách hàng-id.proxy
: URL máy chủ proxy dùng để kết nối Internet.