অনুরোধের ঐচ্ছিক ফিল্ড

API অনুরোধে ঐচ্ছিক ফিল্ড সেট করার সময়, আপনাকে সরাসরি অনুরোধ মেসেজ অবজেক্ট তৈরি করতে হবে এবং পরিষেবা পদ্ধতিতে একটি request প্যারামিটার হিসেবে এটি পাস করতে হবে।

ঐচ্ছিক অনুরোধ ফিল্ড—যেমন GoogleAdsService.Search পদ্ধতিতে validate_only ফিল্ড—ফ্ল্যাটেন করা পদ্ধতি সিগনেচার থেকে বাদ দেওয়া হয় যাতে কীওয়ার্ড প্যারামিটার ম্যানেজ করা যায়, তাই আপনাকে সরাসরি অনুরোধ মেসেজ ইনস্ট্যান্সে সেগুলি সেট করতে হবে।

অনুরোধ অবজেক্ট ফিল্ড প্রয়োজনীয় নাকি ঐচ্ছিক তা নির্ধারণ করতে, Google Ads API protobuf পরিষেবা সংজ্ঞা দেখুন এবং [(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)