Ao definir campos opcionais em uma solicitação de API, você precisa
criar o objeto de mensagem de solicitação diretamente e transmiti-lo como um único request
parâmetro para o método de serviço.
Os campos de solicitação opcionais, como o
validate_only campo no
método GoogleAdsService.Search
, são omitidos das assinaturas de método simplificadas para manter os parâmetros de palavras-chave
gerenciáveis. Portanto, você precisa defini-los diretamente na instância da mensagem de solicitação.
Para determinar se um campo de objeto de solicitação é obrigatório ou opcional, consulte
as definições de serviço do protobuf da API Google Ads e procure
campos que contenham a anotação [(google.api.field_behavior) = REQUIRED].
Os campos sem essa anotação são opcionais.
O exemplo a seguir cria um objeto SearchGoogleAdsRequest e define o
campo validate_only opcional em uma
GoogleAdsService.Search solicitação:
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
googleads_service = client.get_service("GoogleAdsService")
# Initialize the request object and set required fields.
request = client.get_type("SearchGoogleAdsRequest")
request.customer_id = customer_id
request.query = query
# Set the optional validate_only field.
request.validate_only = True
response = googleads_service.search(request=request)