Vous souhaitez nous faire part de vos commentaires sur l'API Google Ads ?
Inscrivez-vous pour être invité à participer à des recherches sur l'expérience utilisateur.
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)
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/03/04 (UTC).
[null,null,["Dernière mise à jour le 2025/03/04 (UTC)."],[[["When using optional fields in Google Ads API requests, construct the request message separately and pass it as a single parameter to the method."],["Optional request headers like `validate_only` are set directly on the request message, not as keyword parameters in the method signature."],["You can identify required or optional request fields by checking the protobuf definitions and looking for the `[(google.api.field_behavior) = REQUIRED]` annotation."],["To use optional fields, create an instance of the request message type, populate its fields including the optional ones, and then pass it to the API method."]]],[]]
