Opcjonalne nagłówki żądania

Jeśli używasz opcjonalnych pól w metodzie żądania, wiadomość żądania musi zostać utworzona poza tą metodą i przekazana jako pojedynczy parametr.

Opcjonalne nagłówki żądania, np. nagłówek validate_only w metodzie GoogleAdsService.Search, nie występują w podpisie metody jako parametry słowa kluczowego, dlatego należy je ustawić bezpośrednio w wiadomości żądania.

Aby określić, czy pole obiektu zapytania jest wymagane, czy opcjonalne, możesz skorzystać z definicji protokołów protobuf dla usług i szukać pól, które zawierają adnotację [(google.api.field_behavior) = REQUIRED].

Oto przykład ustawienia opcjonalnego pola validate_only w żądaniu 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)