การกำหนดค่า

ไลบรารีของไคลเอ็นต์ 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({
  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 ของคุณ

ฟิลด์ที่คงอยู่ใน ไคลเอ็นต์ API:

  • login_customer_id: ดูเอกสารประกอบ login-customer-id
  • proxy: URL ของพร็อกซีเซิร์ฟเวอร์ที่ใช้สำหรับการเชื่อมต่ออินเทอร์เน็ต