可选的请求字段

在 API 请求中设置 可选字段 时,您必须 直接构建请求消息对象,并将其作为单个 request 形参传递给服务方法。

为了便于管理关键字形参,扁平化方法签名中省略了可选的请求字段(例如 validate_only方法中的 GoogleAdsService.Search 字段),因此您必须直接在请求消息实例中设置这些字段。

如需确定请求对象字段是必填字段还是可选字段,请参阅 Google Ads API protobuf 服务定义,并查找包含 [(google.api.field_behavior) = REQUIRED] 注解的字段。 没有此注解的字段是可选字段。

以下示例构建了一个 SearchGoogleAdsRequest 对象,并在 可选的 validate_only 字段上设置了 GoogleAdsService.Search 请求:

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)