การใช้งานพื้นฐานของไลบรารีของไคลเอ็นต์มีดังนี้
การติดตั้ง
วิธีที่แนะนำในการติดตั้งคือการใช้ Bundler เพิ่มบรรทัดลงใน Gemfile (แทนที่ x.y.z ด้วยหมายเลขเวอร์ชันที่คุณต้องการ)
gem 'google-ads-googleads', '~> x.y.z'
จากนั้นเรียกใช้
$ bundle install
คำสั่งนี้ใช้ Bundler เพื่ออัปเดต Gemfile.lock โดยล็อกเวอร์ชันที่แน่นอนของ Gem และการขึ้นต่อกันทั้งหมดของ Gem ที่ติดตั้ง ตัวดำเนินการเวอร์ชันแบบมองโลกในแง่ร้าย
"~> x.y.z" ทำให้ bundle update ติดตั้งเฉพาะ
เวอร์ชันใหม่ในซีรีส์ x.y.* ดังนั้นคุณต้องเลือกใช้เวอร์ชันใหม่ด้วยตนเอง
โดยอัปเดต Gemfile อีกครั้ง
ตัวเลือกในการติดตั้งอื่นๆ
หากไม่ได้ใช้ Bundler คุณสามารถใช้ตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้ได้
- ติดตั้งไลบรารีนี้โดยใช้ Gem:
terminal $ [sudo] gem install google-ads-googleads - ดาวน์โหลด Gem จาก
หน้า "รุ่น" แล้วติดตั้ง
จากไฟล์ในเครื่อง:
terminal $ [sudo] gem install google-ads-googleads-[version].gem
ตั้งค่าการตรวจสอบสิทธิ์
หากต้องการตรวจสอบสิทธิ์การเรียก API ให้ทำตามวิธีการในหน้า การตรวจสอบสิทธิ์และการให้สิทธิ์
การใช้งาน
วิธีรวม Gem ไว้ในโค้ด
require 'google/ads/google_ads'
วิธีดึงข้อมูลบริการที่เฉพาะเจาะจง เช่น CampaignService
client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign
ดูตัวอย่างใน GitHub เพื่อดูการสาธิตโดยละเอียดเพิ่มเติมเกี่ยวกับวิธีใช้ไลบรารี
หลังจากคุ้นเคยกับตัวอย่างแล้ว เราขอแนะนำให้ทำความคุ้นเคย กับ Factory ซึ่งมี ชุดเมธอดระดับสูงที่สะดวกสำหรับการทำงานกับ Google Ads API
การจัดการข้อผิดพลาด
การเรียก API ไม่ได้สำเร็จทุกครั้ง เซิร์ฟเวอร์อาจแสดงข้อผิดพลาดหากการเรียก API ล้มเหลวด้วยเหตุผลบางประการ คุณจึงต้องบันทึกข้อผิดพลาดของ API และจัดการข้อผิดพลาดเหล่านั้นอย่างเหมาะสม
ระบบจะแสดงอินสแตนซ์ GoogleAdsException เมื่อเกิดข้อผิดพลาดของ API โดยจะมีรายละเอียดที่จะช่วยให้คุณทราบว่าเกิดข้อผิดพลาดใด และคุณสามารถตั้งค่าฟังก์ชันตัวช่วยเพื่อจัดการข้อผิดพลาดได้ ดูตัวอย่างตัวจัดการข้อผิดพลาดใน GitHub