Campos de solicitud opcionales

Cuando configuras campos opcionales en una solicitud de API, debes crear el objeto de mensaje de solicitud directamente y pasarlo como un solo request parámetro al método de servicio.

Los campos de solicitud opcionales, como el campo validate_only en el método GoogleAdsService.Search , se omiten de las firmas de métodos aplanadas para que los parámetros de palabras clave sean más fáciles de administrar, por lo que debes configurarlos directamente en la instancia del mensaje de solicitud.

Para determinar si un campo de objeto de solicitud es obligatorio o no, consulta las definiciones de servicio de protobuf de la API de Google Ads y busca los campos que contengan la anotación [(google.api.field_behavior) = REQUIRED]. Los campos sin esta anotación son opcionales.

En el siguiente ejemplo, se crea un objeto SearchGoogleAdsRequest y se configura el campo validate_only opcional en una GoogleAdsService.Search solicitud:

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)