Optionale Anfragefelder

Wenn Sie optionale Felder in einer API-Anfrage festlegen, müssen Sie das Anfrageobjekt direkt erstellen und als einzelnen request Parameter an die Dienstmethode übergeben.

Optionale Anfragenfelder wie das validate_only Feld in der GoogleAdsService.Search Methode werden aus vereinfachten Methodensignaturen entfernt, um die Keyword-Parameter übersichtlich zu halten. Sie müssen sie daher direkt in der Anfragenachricht festlegen.

Ob ein Feld eines Anfrageobjekts erforderlich oder optional ist, erfahren Sie in den Google Ads API-Protobuf-Dienstdefinitionen. Suchen Sie nach Feldern mit der Annotation [(google.api.field_behavior) = REQUIRED]. Felder ohne diese Annotation sind optional.

Im folgenden Beispiel wird ein SearchGoogleAdsRequest Objekt erstellt und das optionale validate_only Feld in einer GoogleAdsService.Search Anfrage festgelegt:

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)