省略可能なリクエスト ヘッダー

リクエスト メソッドでオプション フィールドを使用する場合、リクエスト メッセージをメソッドの外部で作成し、単一のパラメータとして渡す必要があります。

オプションのリクエスト ヘッダー(たとえば、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)