Quando imposti i campi facoltativi in una richiesta API, devi
creare direttamente l'oggetto del messaggio di richiesta e passarlo come singolo request
parametro al metodo del servizio.
I campi di richiesta facoltativi, come il
validate_only campo nel
GoogleAdsService.Searchmetodo
, vengono omessi dalle firme dei metodi appiattite per mantenere gestibili i parametri delle parole chiave
, pertanto devi impostarli direttamente nell'istanza del messaggio di richiesta.
Per determinare se un campo dell'oggetto richiesta è obbligatorio o facoltativo, consulta
le definizioni dei servizi protobuf dell'API Google Ads e cerca
i campi che contengono l'annotazione [(google.api.field_behavior) = REQUIRED].
I campi senza questa annotazione sono facoltativi.
L'esempio seguente crea un oggetto SearchGoogleAdsRequest e imposta il
campo facoltativo validate_only in una
GoogleAdsService.Search richiesta:
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)