การกำหนดค่า

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

ตัวแปรสภาพแวดล้อมการกําหนดค่า

คุณจะกำหนดการตั้งค่าการกำหนดค่าบางส่วนจากตัวแปรสภาพแวดล้อมได้เมื่อตรวจสอบไคลเอ็นต์ (ดูรายการทั้งหมด)

โมดูลไคลเอ็นต์มีฟังก์ชัน 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 มีดังนี้

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