כשמשתמשים בשדות אופציונליים בשיטת בקשה, צריך לבנות את הודעת הבקשה מחוץ לשיטה ולהעביר אותה כפרמטר יחיד.
כותרות אופציונליות של בקשות, כמו הכותרות page_size
ו-validate_only
בשיטה GoogleAdsService.Search
, לא נמצאות בחתימה של השיטה כפרמטרים של מילות מפתח, ולכן צריך להגדיר אותן ישירות בהודעת הבקשה.
כדי לקבוע אם שדה של אובייקט בקשה הוא חובה או אופציונלי, אפשר להפנות להגדרות של Protobuf לשירותים ולחפש שדות שמכילים את ההערה [(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)