هنگام استفاده از هر فیلد اختیاری در روش درخواست، پیام درخواست باید خارج از متد ساخته شده و به عنوان یک پارامتر واحد ارسال شود.
سرصفحههای درخواست اختیاری، برای مثال سرصفحههای page_size
و validate_only
در روش GoogleAdsService.Search
، در امضای روش به عنوان پارامترهای کلیدواژه وجود ندارند، بنابراین باید مستقیماً روی پیام درخواست تنظیم شوند.
برای تعیین اینکه آیا یک فیلد شی درخواست الزامی است یا اختیاری، می توانید به تعاریف پروتوباف برای سرویس ها مراجعه کنید و به دنبال فیلدهایی بگردید که حاوی حاشیه نویسی [(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)