כותרות אופציונליות של בקשות

אם משתמשים בשדות אופציונליים מסוימים בשיטת בקשה, צריך לבנות את הודעת הבקשה מחוץ לשיטה ולהעביר אותה כפרמטר יחיד.

כותרות של בקשות אופציונליות, כמו הכותרות 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)