SearchGoogleAdsRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-ads/json-schema/google-ads-search-google-ads-request-schema.json",
  "title": "SearchGoogleAdsRequest",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-reporting-api-openapi.yml#/components/schemas/SearchGoogleAdsRequest",
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Google Ads Query Language (GAQL) query string. Specifies the\nresources, segments, metrics, and filtering criteria for the data\nto retrieve.\n"
    },
    "pageToken": {
      "type": "string",
      "description": "Token for pagination to retrieve the next page of results."
    },
    "pageSize": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000,
      "description": "Number of results per page. Default is 10000."
    },
    "validateOnly": {
      "type": "boolean",
      "description": "If true, the query is validated but not executed."
    },
    "returnTotalResultsCount": {
      "type": "boolean",
      "description": "If true, includes the total number of results in the response."
    },
    "summaryRowSetting": {
      "type": "string",
      "enum": [
        "NO_SUMMARY_ROW",
        "SUMMARY_ROW_WITH_RESULTS",
        "SUMMARY_ROW_ONLY"
      ],
      "description": "Determines whether a summary row is returned."
    }
  }
}