En-têtes de requête facultatifs

Lorsque vous utilisez des champs facultatifs dans une méthode de requête, le message de requête doit être créé en dehors de la méthode et transmis en tant que paramètre unique.

Les en-têtes de requête facultatifs, par exemple l'en-tête validate_only dans la méthode GoogleAdsService.Search, ne sont pas présents dans la signature de la méthode en tant que paramètres de mot clé. Ils doivent donc être définis directement sur le message de requête.

Pour déterminer si un champ d'objet de requête est obligatoire ou facultatif, vous pouvez consulter les définitions protobuf pour les services et rechercher les champs contenant l'annotation [(google.api.field_behavior) = REQUIRED].

Voici un exemple qui définit le champ validate_only facultatif sur une requête GoogleAdsService.Search:

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

response = googleads_service.search(request=request)