factories
มีอินเทอร์เฟซระดับสูงสำหรับการสร้างการดำเนินการและทรัพยากรด้วยไลบรารีของไคลเอ็นต์
เมธอดของโรงงานจะสร้างขึ้นโดยอัตโนมัติสำหรับทรัพยากร, Enum, การดำเนินการ และประเภทบริการทั้งหมดที่ Google Ads API มีให้
การทำงาน
ไลบรารีนี้มอบวิธีการที่สะดวก client.operation.create_resource.<resource_type>
, client.operation.update_resource.<resource_type>
และ
client.operation.remove_resource.<resource_type>
ในการสร้างการดำเนินการเพื่อทำงานร่วมกับ Google Ads API ได้อย่างง่ายดาย
ตัวอย่างการสร้างทรัพยากรมีดังนี้
campaign_budget_operation = client.operation.create_resource.campaign_budget do |cb|
cb.name = "Interplanetary Budget #{(Time.new.to_f * 1000).to_i}"
cb.delivery_method = :STANDARD
cb.amount_micros = 500000
end
return_budget = client.service.campaign_budget.mutate_campaign_budgets(
customer_id,
[campaign_budget_operation]
)
โปรดทราบว่าออบเจ็กต์ที่ส่งไปยังการบล็อก cb
เป็นอินสแตนซ์ใหม่ของ CampaignBudget
ที่คุณเปลี่ยนแปลงได้ และจะแสดงการดำเนินการสร้างที่เหมาะสมสำหรับ CampaignBudgetService
ในทำนองเดียวกัน เรามีวิธีอำนวยความสะดวกในการอัปเดตดังนี้
# if you only have a resource name
update_operation = client.operation.update_resource.campaign(campaign_resource_name) do |camp|
camp.status = :PAUSED
end
campaign_service.mutate_campaigns(customer_id, [update_operation])
# if you have a full resource proto
update_operation = client.operation.update_resource.campaign(campaign) do
campaign.name = "A different interplanetary Cruise #{(Time.new.to_f * 1000).to_i}"
end
campaign_service.mutate_campaigns(customer_id, [update_operation])
การเรียกเหล่านี้จะส่งคืนการดำเนินการอัปเดตที่มีรูปแบบถูกต้อง โดยมีฟิลด์มาสก์ที่ป้อนข้อมูลไว้ล่วงหน้าเพื่ออัปเดตทรัพยากรใน Google Ads API
ตัวอย่างการนำทรัพยากรออกโดยใช้เส้นทางทรัพยากรมีดังนี้
remove_operation = client.operation.remove_resource.campaign(campaign_resource_name)
campaign_service.mutate_campaigns(customer_id, [remove_operation])
หากต้องการดำเนินการด้วยตนเอง คุณก็ดูการดำเนินการดิบแล้วป้อนข้อมูลในช่องด้วยตนเองได้
operation = client.operation.campaign
แหล่งข้อมูล
ไลบรารีมี client.resource.<resource_type>
เป็นวิธีเริ่มต้นออบเจ็กต์ทรัพยากรต่างๆ ที่สะดวก ดังนี้
campaign.network_settings = client.resource.network_settings do |ns|
ns.target_google_search = true
ns.target_search_network = true
ns.target_content_network = false
ns.target_partner_search_network = false
end
ระบบจะส่งคืนอินสแตนซ์ใหม่ของประเภททรัพยากรที่ขอให้กับการบล็อกที่ส่งผ่านสำหรับฟิลด์การตั้งค่า
บริการ
ไลบรารีที่มี client.service.<service_name>
เป็นช่องทางที่สะดวกในการรับออบเจ็กต์บริการ ได้แก่
campaign_service = client.service.campaign
Enum
เราขอแนะนำให้ใช้ไวยากรณ์สัญลักษณ์สำหรับการตั้งค่าช่อง enum แบบคงที่
(เช่น campaign.status = :PAUSED
) อย่างไรก็ตาม หากคุณต้องการแจกแจงค่าที่ถูกต้องทั้งหมดสำหรับ Enum เรายังมีเมธอดให้ด้วย เช่น
client.enum.ad_type.each { |x| p x }
:SHOPPING_PRODUCT_AD
:GMAIL_AD
:UNKNOWN
:UNSPECIFIED
:CALL_ONLY_AD
:VIDEO_AD
:IMAGE_AD
:EXPANDED_DYNAMIC_SEARCH_AD
:RESPONSIVE_DISPLAY_AD
:TEXT_AD
:LEGACY_RESPONSIVE_DISPLAY_AD
:LEGACY_APP_INSTALL_AD
:APP_AD
:SHOPPING_SMART_AD
:EXPANDED_TEXT_AD
:HOTEL_AD
:RESPONSIVE_SEARCH_AD
การตั้งค่าเวอร์ชัน Google Ads API อย่างชัดเจน
นอกจากนี้คุณยังสามารถตั้งค่าเวอร์ชันอย่างชัดแจ้งได้ดังนี้
client.resource.v17.[entity]
client.operation.v17.[operation]
client.service.v17.[service]
client.enum.v17.[enum]