GoogleAdsGoogleadsV25Services__MutateAdGroupLabelsRequest

{
  "$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-labels-request-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__MutateAdGroupLabelsRequest",
  "description": "Request message for AdGroupLabelService.MutateAdGroupLabels.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-customers-adgrouplabels-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__MutateAdGroupLabelsRequest",
  "type": "object",
  "properties": {
    "partialFailure": {
      "type": "boolean",
      "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."
    },
    "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 labels.",
      "items": {
        "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__AdGroupLabelOperation"
      },
      "type": "array"
    }
  },
  "$defs": {
    "GoogleAdsGoogleadsV25Resources__AdGroupLabel": {
      "type": "object",
      "properties": {
        "label": {
          "description": "Immutable. The label assigned to the ad group.",
          "type": "string"
        },
        "adGroup": {
          "type": "string",
          "description": "Immutable. The ad group to which the label is attached."
        },
        "resourceName": {
          "description": "Immutable. The resource name of the ad group label. Ad group label resource names have the form: `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}`",
          "type": "string"
        }
      },
      "description": "A relationship between an ad group and a label."
    },
    "GoogleAdsGoogleadsV25Services__AdGroupLabelOperation": {
      "description": "A single operation (create, remove) on an ad group label.",
      "type": "object",
      "properties": {
        "create": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__AdGroupLabel",
          "description": "Create operation: No resource name is expected for the new ad group label."
        },
        "remove": {
          "type": "string",
          "description": "Remove operation: A resource name for the ad group label being removed, in this format: `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}`"
        }
      }
    }
  }
}