API リクエストでオプション フィールドを設定する場合は、リクエスト メッセージ オブジェクトを直接作成し、サービス メソッドに単一の request
パラメータとして渡す必要があります。
`GoogleAdsService.Search` メソッドの
validate_only フィールドなどの省略可能なリクエスト フィールドは、キーワード パラメータを管理しやすくするために、フラット化されたメソッド シグネチャから除外されます。そのため、リクエスト メッセージ インスタンスに直接設定する必要があります。
リクエスト オブジェクト フィールドが必須か省略可能かを判断するには、
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)