En-têtes de requête facultatifs

Lorsque vous utilisez des champs facultatifs sur une méthode de requête, le message de requête doit être construit en dehors de la méthode et transmis sous la forme d'un seul paramètre.

Les en-têtes de requêtes facultatifs, par exemple les en-têtes page_size et 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 requis 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)