設定

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
});

在這種情況下，用戶端會在該檔案路徑中尋找檔案。

產生此檔案最簡單的方法，就是從 GitHub 存放區複製 googleads.properties，然後修改該檔案，加入您的用戶端 ID、用戶端密鑰和重新整理權杖。

動態設定

您可以在例項化程式庫時動態設定設定，甚至可以在之後再進行設定：

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");

您也可以從 API Client 取得 OAuth2ApplicationsHandler 物件，並在執行階段變更用戶端 ID、用戶端密鑰和重新整理權杖：

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 用戶端 ID。
  • client_secret：您的 OAuth2 用戶端密鑰。
  • refresh_token：您的 OAuth2 更新權杖。

在 API 用戶端中保留的欄位：

  • developer_token：用於存取 API 的開發人員權杖。
  • login_customer_id：請參閱 login-customer-id 說明文件。
  • proxy：用於網際網路連線的 Proxy 伺服器網址。