การกำหนดค่า

การกำหนดค่านั้นใช้คลาส 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: โทเค็นการรีเฟรช OAuth
• client_id: รหัสไคลเอ็นต์ OAuth
• client_secret: รหัสลับไคลเอ็นต์ OAuth
• developer_token: โทเค็นของนักพัฒนาสำหรับเข้าถึง API
• login_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