การกำหนดค่า

กำหนดค่าโดยใช้ชั้นเรียน 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: ดู เอกสารlogin-customer-id

ฟิลด์การบันทึก ดูรายละเอียดทั้งหมดได้ในคู่มือการบันทึก

  • log_level: ข้อความระดับบันทึกขั้นต่ำที่คุณต้องการบันทึก ตัวอย่างเช่น การระบุ 'DEBUG' จะช่วยให้คุณเห็นข้อความบันทึกทั้งหมดและระบุ 'INFO' จะไม่รวมข้อความ DEBUG แต่จะแสดงข้อความอื่นๆ ทั้งหมด
  • log_target: ที่ที่คุณต้องการเข้าสู่ระบบ เช่น STDERR
  • logger: ระบุตัวบันทึกที่คุณกำหนดเอง การระบุการดำเนินการนี้จะลบล้างทั้ง 2 อย่าง 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