سرصفحه های درخواست اختیاری

هنگام استفاده از هر فیلد اختیاری در روش درخواست، پیام درخواست باید خارج از متد ساخته شده و به عنوان یک پارامتر واحد ارسال شود.

سرصفحه‌های درخواست اختیاری، برای مثال سرصفحه‌های 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)