ฟิลด์คำขอที่ไม่บังคับ

เมื่อตั้งค่าฟิลด์ตัวเลือกในคำขอ API คุณต้องสร้างออบเจ็กต์ข้อความคำขอโดยตรงและส่งเป็นพารามิเตอร์ request รายการเดียวไปยังเมธอดบริการ

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

หากต้องการตรวจสอบว่าช่องออบเจ็กต์คำขอเป็นช่องที่ต้องกรอกหรือไม่ ให้ดูคำจำกัดความของบริการ Protobuf ของ Google Ads API และมองหาช่องที่มีคำอธิบายประกอบ [(google.api.field_behavior) = REQUIRED] ส่วนช่องที่ไม่มีคำอธิบายประกอบนี้จะระบุหรือไม่ก็ได้

ตัวอย่างต่อไปนี้จะสร้างออบเจ็กต์ SearchGoogleAdsRequest และตั้งค่าฟิลด์ validate_only ที่ไม่บังคับในคำขอ GoogleAdsService.Search

from google.ads.googleads.client import GoogleAdsClient

client = GoogleAdsClient.load_from_storage()
googleads_service = client.get_service("GoogleAdsService")

# Initialize the request object and set required fields.
request = client.get_type("SearchGoogleAdsRequest")
request.customer_id = customer_id
request.query = query

# Set the optional validate_only field.
request.validate_only = True

response = googleads_service.search(request=request)