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

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

سرصفحه های درخواست اختیاری، به عنوان مثال سرصفحه validate_only در روش GoogleAdsService.Search ، در امضای روش به عنوان پارامترهای کلیدواژه وجود ندارند، بنابراین باید مستقیماً روی پیام درخواست تنظیم شوند.

برای تعیین اینکه آیا یک فیلد شی درخواست الزامی است یا اختیاری، می توانید به تعاریف پروتوباف برای سرویس ها مراجعه کنید و به دنبال فیلدهایی بگردید که حاوی حاشیه نویسی [(google.api.field_behavior) = REQUIRED] هستند.

در اینجا یک مثال است که فیلد اختیاری validate_only در یک درخواست GoogleAdsService.Search تنظیم می‌کند:

request = client.get_type("SearchGoogleAdsRequest")
request.customer_id = customer_id
request.query = query
request.validate_only = True

response = googleads_service.search(request=request)