Podczas ustawiania pól opcjonalnych w żądaniu do interfejsu API musisz bezpośrednio utworzyć obiekt wiadomości żądania i przekazać go jako pojedynczy request parametr do metody usługi.
Opcjonalne pola żądania, takie jak pole
validate_only w
metodzie GoogleAdsService.Search
, są pomijane w spłaszczonych sygnaturach metod, aby ułatwić zarządzanie parametrami słów kluczowych
. Musisz je ustawić bezpośrednio w instancji wiadomości żądania.
Aby sprawdzić, czy pole obiektu żądania jest wymagane czy opcjonalne, zapoznaj się z definicjami usług interfejsu Google Ads API protobuf i poszukaj pól zawierających adnotację [(google.api.field_behavior) = REQUIRED].
Pola bez tej adnotacji są opcjonalne.
Poniższy przykład tworzy obiekt SearchGoogleAdsRequest i ustawia
opcjonalne pole validate_only w żądaniu
GoogleAdsService.Search:
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
googleads_service = client.get_service("GoogleAdsService")
# Initialize the request object and set required fields.
request = client.get_type("SearchGoogleAdsRequest")
request.customer_id = customer_id
request.query = query
# Set the optional validate_only field.
request.validate_only = True
response = googleads_service.search(request=request)