การกำหนดค่านั้นใช้คลาส Config
คุณสามารถเข้าถึงคลาสนี้ได้หลายวิธี เช่น การเขียนไฟล์การกำหนดค่า การระบุค่าเมื่อสร้าง หรือการโหลดค่าจากตัวแปรสภาพแวดล้อม
ไฟล์การกำหนดค่า
คุณระบุไฟล์ google_ads_config.rb
ที่จะใช้เมื่อสร้างอินสแตนซ์ไคลเอ็นต์ได้
หากคุณไม่ได้ใช้อาร์กิวเมนต์เมื่อสร้างอินสแตนซ์ ให้ทำดังนี้
client = Google::Ads::GoogleAds::GoogleAdsClient.new
ไลบรารีจะดูในตำแหน่งที่ระบุในตัวแปรสภาพแวดล้อม GOOGLE_ADS_CONFIGURATION_FILE_PATH
หากไม่ได้ตั้งค่าตัวแปรไว้ ไลบรารีจะค้นหาไฟล์ในไดเรกทอรี HOME
อีกทางเลือกหนึ่งคือ คุณสามารถระบุเส้นทางได้ดังนี้
client = Google::Ads::GoogleAds::GoogleAdsClient.new("path/to/file.rb")
ซึ่งในกรณีนี้ ไคลเอ็นต์จะค้นหาไฟล์ที่เส้นทางของไฟล์นั้น
วิธีที่ง่ายที่สุดในการสร้างไฟล์นี้คือคัดลอก google_ads_config.rb
จากที่เก็บ GitHub แล้วแก้ไขเพื่อรวมโทเค็นการรีเฟรช รหัสไคลเอ็นต์ และรหัสลับไคลเอ็นต์
การกำหนดค่าแบบไดนามิก
คุณสามารถตั้งค่าการกำหนดค่าแบบไดนามิกได้เมื่อมีการเริ่มต้นไลบรารี หรือหลังจากนั้น
client = Google::Ads::GoogleAds::GoogleAdsClient.new do |config|
config.client_id = 'INSERT_CLIENT_ID_HERE'
# ... more configuration
end
คุณยังแก้ไขการกำหนดค่าหลังจากทำอินสแตนซ์ได้ด้วย โดยทำดังนี้
client.configure do |config|
config.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
# ... more configuration
end
ช่องการกําหนดค่า
ออบเจ็กต์ Config
รองรับช่องต่อไปนี้
ช่องทั่วไป
refresh_token
: โทเค็นการรีเฟรช OAuthclient_id
: รหัสไคลเอ็นต์ OAuthclient_secret
: รหัสลับไคลเอ็นต์ OAuthdeveloper_token
: โทเค็นของนักพัฒนาสำหรับเข้าถึง APIlogin_customer_id
: ดูเอกสารประกอบเกี่ยวกับรหัสลูกค้าสำหรับการเข้าสู่ระบบ
ช่อง Logging โปรดดูรายละเอียดทั้งหมดในคู่มือการบันทึก
log_level
: ข้อความระดับการบันทึกขั้นต่ำที่คุณต้องการบันทึก ตัวอย่างเช่น การระบุ'DEBUG'
จะช่วยให้คุณเห็นข้อความบันทึกทั้งหมด และการระบุ'INFO'
จะยกเว้นข้อความการแก้ไขข้อบกพร่องแต่จะแสดงข้อความอื่นๆ ทั้งหมดlog_target
: ตำแหน่งที่ต้องการเข้าสู่ระบบ เช่นSTDERR
logger
: ระบุตัวบันทึกที่กำหนดเอง การระบุค่านี้จะลบล้างทั้งlog_level
และlog_target
ตัวแปรสภาพแวดล้อม
คุณสามารถกำหนดค่าไลบรารีไคลเอ็นต์โดยใช้ตัวแปรสภาพแวดล้อมได้ การดำเนินการนี้จะไม่โหลดโดยค่าเริ่มต้น และต้องมีการเรียกเพิ่มเติมหลังจากที่สร้างอินสแตนซ์ไคลเอ็นต์เพื่อที่จะโหลด ดูรายการตัวแปรสภาพแวดล้อมทั้งหมดที่ทุกภาษารองรับ
หากต้องการโหลดตัวแปรสภาพแวดล้อมลงใน Config
ให้เรียกใช้ load_environment_config
:
client = Google::Ads::GoogleAds::GoogleAdsClient.new
client.load_environment_config
ทุกครั้งที่มีการเรียกใช้ตัวแปรนี้ สถานะปัจจุบันของตัวแปรสภาพแวดล้อมจะเขียนทับทุกอย่างที่มีอยู่ใน Config
อยู่แล้ว กลไกนี้ช่วยยกตัวอย่าง เช่น อาจมีการกำหนดค่าเริ่มต้น แต่จะลบล้างค่าที่เจาะจงโดยใช้ตัวแปรสภาพแวดล้อม หรือคุณจะกำหนดค่าทั้งหมดด้วยตัวแปรสภาพแวดล้อมก็ได้
นอกจากตัวแปรสภาพแวดล้อมที่ไลบรารีทั้งหมดรองรับแล้ว ไลบรารี Ruby ยังมีตัวแปรเพิ่มเติมอีก 2 ตัว ได้แก่
GOOGLE_ADS_RUBY_LOG_LEVEL
: ดังที่log_level
ข้างต้นGOOGLE_ADS_RUBY_HTTP_PROXY
: ระบุพร็อกซี HTTP