可选请求标头

在请求方法中使用任何可选字段时，请求消息必须在该方法之外构建，并作为单个参数传入。

可选的请求标头（例如 GoogleAdsService.Search 方法中的 page_size 和 validate_only 标头）不会作为关键字参数出现在方法签名中，因此必须直接在请求消息上设置它们。

如需确定请求对象字段是必填字段还是选填字段，您可以参考服务的 protobuf 定义，并查找包含 [(google.api.field_behavior) = REQUIRED] 注解的字段。

以下示例展示了如何在 GoogleAdsService.Search 请求中设置可选的 page_size 和 validate_only 字段：

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)