MutateAdGroupCriteriaRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-ads/json-schema/google-ads-mutate-ad-group-criteria-request-schema.json",
  "title": "MutateAdGroupCriteriaRequest",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-keywords-api-openapi.yml#/components/schemas/MutateAdGroupCriteriaRequest",
  "type": "object",
  "required": [
    "operations"
  ],
  "properties": {
    "operations": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AdGroupCriterionOperation"
      }
    },
    "partialFailure": {
      "type": "boolean"
    },
    "validateOnly": {
      "type": "boolean"
    }
  },
  "$defs": {
    "AdGroupCriterion": {
      "type": "object",
      "description": "A targeting criterion within an ad group, such as a keyword.",
      "properties": {
        "resourceName": {
          "type": "string",
          "description": "Resource name of the ad group criterion."
        },
        "criterionId": {
          "type": "integer",
          "format": "int64",
          "description": "The unique ID of the criterion."
        },
        "adGroup": {
          "type": "string",
          "description": "Resource name of the ad group this criterion belongs to."
        },
        "status": {
          "type": "string",
          "enum": [
            "ENABLED",
            "PAUSED",
            "REMOVED",
            "UNKNOWN",
            "UNSPECIFIED"
          ],
          "description": "The status of the criterion."
        },
        "type": {
          "type": "string",
          "enum": [
            "KEYWORD",
            "PLACEMENT",
            "TOPIC",
            "AGE_RANGE",
            "GENDER",
            "INCOME_RANGE",
            "PARENTAL_STATUS",
            "LISTING_GROUP",
            "WEBPAGE",
            "CUSTOM_AUDIENCE",
            "AUDIENCE",
            "UNKNOWN",
            "UNSPECIFIED"
          ],
          "description": "The type of criterion."
        },
        "keyword": {
          "$ref": "#/$defs/KeywordInfo"
        },
        "qualityInfo": {
          "$ref": "#/$defs/QualityInfo"
        },
        "cpcBidMicros": {
          "type": "integer",
          "format": "int64",
          "description": "CPC bid override in micros for this criterion."
        },
        "effectiveCpcBidMicros": {
          "type": "integer",
          "format": "int64",
          "description": "Effective CPC bid in micros after applying all adjustments."
        },
        "finalUrls": {
          "type": "array",
          "items": {
            "type": "string",
            "format": "uri"
          },
          "description": "Override landing page URLs for this keyword."
        },
        "negative": {
          "type": "boolean",
          "description": "Whether this is a negative criterion (excluded from targeting)."
        }
      }
    },
    "AdGroupCriterionOperation": {
      "type": "object",
      "properties": {
        "create": {
          "$ref": "#/$defs/AdGroupCriterion"
        },
        "update": {
          "$ref": "#/$defs/AdGroupCriterion"
        },
        "remove": {
          "type": "string"
        },
        "updateMask": {
          "type": "string"
        }
      }
    },
    "KeywordInfo": {
      "type": "object",
      "description": "Keyword targeting information.",
      "properties": {
        "text": {
          "type": "string",
          "description": "The keyword text."
        },
        "matchType": {
          "type": "string",
          "enum": [
            "EXACT",
            "PHRASE",
            "BROAD",
            "UNKNOWN",
            "UNSPECIFIED"
          ],
          "description": "The match type of the keyword."
        }
      }
    },
    "QualityInfo": {
      "type": "object",
      "description": "Quality score and component metrics for a keyword.",
      "properties": {
        "qualityScore": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10,
          "description": "Quality Score on a 1-10 scale."
        },
        "creativeQualityScore": {
          "type": "string",
          "enum": [
            "ABOVE_AVERAGE",
            "AVERAGE",
            "BELOW_AVERAGE",
            "UNKNOWN",
            "UNSPECIFIED"
          ],
          "description": "Ad relevance quality component."
        },
        "postClickQualityScore": {
          "type": "string",
          "enum": [
            "ABOVE_AVERAGE",
            "AVERAGE",
            "BELOW_AVERAGE",
            "UNKNOWN",
            "UNSPECIFIED"
          ],
          "description": "Landing page experience quality component."
        },
        "searchPredictedCtr": {
          "type": "string",
          "enum": [
            "ABOVE_AVERAGE",
            "AVERAGE",
            "BELOW_AVERAGE",
            "UNKNOWN",
            "UNSPECIFIED"
          ],
          "description": "Expected click-through rate quality component."
        }
      }
    }
  }
}