Campi di richiesta facoltativi

Quando imposti campi facoltativi in una richiesta API, devi creare direttamente l'oggetto del messaggio di richiesta e passarlo come singolo parametro request al metodo del servizio.

I campi facoltativi della richiesta, come il campo validate_only nel metodo GoogleAdsService.Search, vengono omessi dalle firme dei metodi flattati per mantenere gestibili i parametri delle parole chiave, quindi devi impostarli direttamente nell'istanza del messaggio di richiesta.

Per determinare se un campo dell'oggetto della richiesta è obbligatorio o facoltativo, consulta le definizioni del servizio 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 su una richiesta 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)