Cabeçalhos de solicitação opcionais

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

Os cabeçalhos de solicitação opcionais, por exemplo, os cabeçalhos page_size e 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, consulte as definições protobuf para serviços e procure campos que contenham a anotação [(google.api.field_behavior) = REQUIRED].

Confira um exemplo que define os campos opcionais page_size e validate_only em uma solicitação 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)