אם משתמשים בשדות אופציונליים מסוימים בשיטת בקשה, צריך לבנות את הודעת הבקשה מחוץ לשיטה ולהעביר אותה כפרמטר יחיד.
כותרות של בקשות אופציונליות, כמו הכותרות 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)