{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-ads/json-schema/google-ads-google-ads-googleads-v25-services-mutate-ad-group-ad-labels-request-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__MutateAdGroupAdLabelsRequest",
  "description": "Request message for AdGroupAdLabelService.MutateAdGroupAdLabels.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-customers-adgroupadlabels-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__MutateAdGroupAdLabelsRequest",
  "type": "object",
  "properties": {
    "validateOnly": {
      "type": "boolean",
      "description": "If true, the request is validated but not executed. Only errors are returned, not results."
    },
    "operations": {
      "description": "Required. The list of operations to perform on ad group ad labels.",
      "items": {
        "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__AdGroupAdLabelOperation"
      },
      "type": "array"
    },
    "partialFailure": {
      "description": "If true, successful operations will be carried out and invalid operations will return errors. If false, all operations will be carried out in one transaction if and only if they are all valid. Default is false.",
      "type": "boolean"
    }
  },
  "$defs": {
    "GoogleAdsGoogleadsV25Resources__AdGroupAdLabel": {
      "description": "A relationship between an ad group ad and a label.",
      "type": "object",
      "properties": {
        "adGroupAd": {
          "description": "Immutable. The ad group ad to which the label is attached.",
          "type": "string"
        },
        "label": {
          "description": "Immutable. The label assigned to the ad group ad.",
          "type": "string"
        },
        "resourceName": {
          "type": "string",
          "description": "Immutable. The resource name of the ad group ad label. Ad group ad label resource names have the form: `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}`"
        }
      }
    },
    "GoogleAdsGoogleadsV25Services__AdGroupAdLabelOperation": {
      "type": "object",
      "properties": {
        "create": {
          "description": "Create operation: No resource name is expected for the new ad group ad label.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__AdGroupAdLabel"
        },
        "remove": {
          "description": "Remove operation: A resource name for the ad group ad label being removed, in this format: `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}`",
          "type": "string"
        }
      },
      "description": "A single operation (create, remove) on an ad group ad label."
    }
  }
}