ยูทิลิตีการค้นหา

การดึงข้อมูลอ้างอิงไปยังคลาส Proto เมื่อใช้ API กำหนดให้คุณต้อง มีความเข้าใจโดยสัญชาตญาณเกี่ยวกับ API หรือค้นหาเอกสารอ้างอิง Proto บ่อยๆ เพื่อดูเส้นทางเนมสเปซที่แน่นอน

ProtoLookupUtil

เมธอดของยูทิลิตีการค้นหาใน GoogleAdsClient (ซึ่งได้รับการสนับสนุนจาก Factories และ ServiceLookup ซึ่งแทนที่คลาส ProtoLookupUtil เดิม) ช่วยให้คุณค้นหาและสร้างอินสแตนซ์ของบริการ การดำเนินการ การแจงนับ และทรัพยากรได้โดยไม่ต้องติดตามหมายเลขเวอร์ชัน API และเนมสเปซของโมดูล โดยค่าเริ่มต้น เมธอดเหล่านี้จะใช้เวอร์ชัน API สูงสุด ที่ Gem ที่ติดตั้งรองรับ (V25 ใน รุ่นล่าสุด ซึ่งการเผยแพร่ API ย่อย เช่น v25.1 จะใช้โมดูลเวอร์ชันหลัก V25) หรือคุณจะระบุคำนำหน้าเวอร์ชันที่ชัดเจน (เช่น v25) ในการเรียกการค้นหาได้

หากไม่มีเครื่องมือค้นหา คุณจะสร้างอินสแตนซ์ทรัพยากรแคมเปญได้โดยตรงจาก เนมสเปซที่มีการควบคุมเวอร์ชัน

campaign =
  Google::Ads::GoogleAds::V25::Resources::Campaign.new

เมื่อใช้เมธอดการค้นหาไคลเอ็นต์ คุณจะสร้างอินสแตนซ์ของทรัพยากรได้โดยตรงจากไคลเอ็นต์โดยใช้โค้ดต่อไปนี้

campaign = client.resource.campaign

เมื่อดึงข้อมูลทรัพยากร บริการ หรือการดำเนินการ ระบบจะแสดงอินสแตนซ์ของเอนทิตีนั้น

# Instantiate an operation
operation = client.operation.campaign

การค้นหาบริการ

ใช้เมธอด client.service เพื่อดึงข้อมูลไคลเอ็นต์บริการ แม้ว่าคุณจะไม่ได้ใช้ ยูทิลิตี้นี้สำหรับเอนทิตีอื่นๆ ก็ตาม client.service จะกำหนดค่า ข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์และการตั้งค่าการรับส่งในไคลเอ็นต์ บริการที่ส่งคืนโดยอัตโนมัติ

campaign_service = client.service.campaign

การค้นหาการแจงนับ

สำหรับฟิลด์ enum ในข้อความ protobuf ให้กำหนดสัญลักษณ์ Ruby โดยตรงแทนการ ค้นหาโมดูลการแจงนับ

campaign.status = :PAUSED

หากต้องการตรวจสอบหรือวนซ้ำสัญลักษณ์ที่ถูกต้องทั้งหมดสำหรับการแจงนับที่รันไทม์ ให้ใช้ client.enum ซึ่งจะแสดงผล Google::Protobuf::EnumDescriptor สำหรับ enum นั้น

status_enum = client.enum.campaign_status
status_enum.each { |status| p status }