เมื่อใช้ช่องที่ไม่บังคับในเมธอดคําขอ ข้อความคําขอต้องสร้างขึ้นนอกเมธอด และส่งผ่านเป็นพารามิเตอร์เดี่ยว
ส่วนหัวของคําขอแบบไม่บังคับ เช่น ส่วนหัว page_size
และ validate_only
ในเมธอด GoogleAdsService.Search
จะไม่ปรากฏในลายเซ็นของเมธอดเป็นพารามิเตอร์คีย์เวิร์ด ดังนั้นจึงต้องตั้งค่าในส่วนหัวของคําขอโดยตรง
ในการพิจารณาว่าจําเป็นต้องมีช่องออบเจ็กต์คําขอหรือไม่ (ไม่บังคับ) คุณสามารถอ้างอิงคําจํากัดความของ protobuf สําหรับบริการ และมองหาช่องที่มีคําอธิบายประกอบ [(google.api.field_behavior) =
REQUIRED]
นี่คือตัวอย่างที่ตั้งค่าช่อง page_size
และ validate_only
(ไม่บังคับ) ในคําขอ GoogleAdsService.Search
request = client.get_type("SearchGoogleAdsRequest")
request.customer_id = customer_id
request.query = query
request.page_size = 10000
request.validate_only = True
response = googleads_service.search(request=request)