Optionale Anfrageheader

Wenn optionale Felder in einer Anfragemethode verwendet werden, muss die Anfragenachricht außerhalb der Methode erstellt und als einzelner Parameter übergeben werden.

Optionale Anfrageheader wie die Header page_size und validate_only in der Methode GoogleAdsService.Search sind in der Methodensignatur nicht als Schlüsselwortparameter vorhanden. Sie müssen daher direkt in der Anfragenachricht festgelegt werden.

Um festzustellen, ob ein Anfrageobjektfeld erforderlich oder optional ist, können Sie auf die protobuf-Definitionen für Dienste verweisen und nach Feldern suchen, die die Annotation [(google.api.field_behavior) = REQUIRED] enthalten.

Im folgenden Beispiel werden die optionalen Felder page_size und validate_only in einer GoogleAdsService.Search-Anfrage festgelegt:

request = client.get_type("SearchGoogleAdsRequest")
request.customer_id = customer_id
request.query = query
request.page_size = 10000
request.validate_only = True

response = googleads_service.search(request=request)