在请求方法中使用任何可选字段时,必须在方法之外构建请求消息,并将其作为单个参数传入。
可选请求标头(例如 GoogleAdsService.Search
方法中的 validate_only
标头)不会以关键字参数的形式出现在方法签名中,因此必须直接在请求消息中进行设置。
如需确定请求对象字段是必需字段还是可选字段,您可以参考服务的 protobuf 定义,并查找包含注解 [(google.api.field_behavior) =
REQUIRED]
的字段。
以下示例展示了如何在 GoogleAdsService.Search
请求中设置可选的 validate_only
字段:
request = client.get_type("SearchGoogleAdsRequest")
request.customer_id = customer_id
request.query = query
request.validate_only = True
response = googleads_service.search(request=request)