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

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

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