Cấu hình

Thư viện ứng dụng Ads API cung cấp một số chế độ cài đặt cấu hình mà bạn có thể dùng để tuỳ chỉnh hành vi 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ể cho ứng dụng.

Nếu bạn không sử dụng đối số khi khởi tạo:

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 theo đườ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 rồi sửa đổi tệp đó để thêm mã ứng dụng, khoá bí mật ứng dụng 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 khởi tạo thư viện hoặc thậm chí 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 khởi tạo:

$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, khoá bí mật của ứng dụng 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 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 khởi tạo ứng dụng (xem danh sách đầy đủ).

Mô-đun Client 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();

Các trường cấu hình

Các thuộc tính cấu hình hỗ trợ những trường sau:

Các trường được duy trì trong OAuth2ApplicationsHandler:

  • client_id: Mã ứng dụng OAuth2 của bạn.
  • client_secret: Khoá bí mật của ứng dụng OAuth2.
  • refresh_token: Mã làm mới OAuth2 của bạn.

Các trường được duy trì trong Ứng dụng API:

  • developer_token: Mã thông báo nhà phát triển của bạn để truy cập vào API.
  • login_customer_id: Xem tài liệu về login-customer-id.
  • proxy: URL máy chủ proxy dùng để kết nối Internet.