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 construit en dehors de la méthode et transmis en tant que paramètre unique.

Les en-têtes de requête facultatifs, tels que les en-têtes page_size et validate_only de 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 dans le message de requête.

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

Voici un exemple qui définit les champs facultatifs page_size et validate_only sur une requête GoogleAdsService.Search:

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)