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

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

כותרות בקשה אופציונליות, למשל הכותרת validate_only בשיטה GoogleAdsService.Search, לא מופיעות בחתימת השיטה כפרמטרים של מילות מפתח, ולכן צריך להגדיר אותן ישירות בהודעת הבקשה.

כדי לקבוע אם שדה של אובייקט בקשה הוא חובה או אופציונלי, אפשר לעיין בהגדרות ה-protobuf לשירותים ולחפש שדות שמכילים את ההערה [(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)