अनुरोध के ऐसे फ़ील्ड जो ज़रूरी नहीं हैं

एपीआई अनुरोध पर ज़रूरी नहीं वाले फ़ील्ड सेट करते समय, आपको अनुरोध मैसेज ऑब्जेक्ट को सीधे तौर पर बनाना होगा और इसे सेवा के तरीके में एक request पैरामीटर के तौर पर पास करना होगा.

अनुरोध के वैकल्पिक फ़ील्ड, जैसे कि GoogleAdsService.Search तरीके में validate_only फ़ील्ड को फ़्लैट किए गए तरीके के सिग्नेचर से हटा दिया जाता है, ताकि कीवर्ड पैरामीटर को मैनेज किया जा सके. इसलिए, आपको उन्हें सीधे अनुरोध मैसेज के इंस्टेंस पर सेट करना होगा.

यह तय करने के लिए कि अनुरोध ऑब्जेक्ट फ़ील्ड ज़रूरी है या वैकल्पिक, Google Ads API प्रोटॉबफ़ सेवा की परिभाषाएं देखें. साथ ही, ऐसे फ़ील्ड देखें जिनमें एनोटेशन [(google.api.field_behavior) = REQUIRED] शामिल है. जिन फ़ील्ड में यह एनोटेशन नहीं है उन्हें भरना ज़रूरी नहीं है.

यहां दिए गए उदाहरण में, SearchGoogleAdsRequest ऑब्जेक्ट बनाया गया है. साथ ही, GoogleAdsService.Search अनुरोध पर, validate_only फ़ील्ड को सेट किया गया है. यह फ़ील्ड ज़रूरी नहीं है:

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)