Cabeçalhos de solicitação opcionais

Ao usar campos opcionais em um método de solicitação, a mensagem de solicitação precisa ser criada fora do método e transmitida como um único parâmetro.

Cabeçalhos de solicitação opcionais, por exemplo, o cabeçalho validate_only no método GoogleAdsService.Search, não estão presentes na assinatura do método como parâmetros de palavra-chave. Portanto, eles precisam ser definidos diretamente na mensagem de solicitação.

Para determinar se um campo de objeto de solicitação é obrigatório ou opcional, você pode referenciar as definições de protobuf para serviços e procurar campos que contenham a anotação [(google.api.field_behavior) = REQUIRED].

Confira um exemplo que define o campo validate_only opcional em uma solicitação 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)