GoogleAdsGoogleadsV25Services__MutateRemarketingActionsRequest

{
  "$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-remarketing-actions-request-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__MutateRemarketingActionsRequest",
  "description": "Request message for RemarketingActionService.MutateRemarketingActions.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-customers-remarketingactions-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__MutateRemarketingActionsRequest",
  "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 individual remarketing actions.",
      "items": {
        "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__RemarketingActionOperation"
      },
      "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": {
    "GoogleAdsGoogleadsV25Common__TagSnippet": {
      "description": "The site tag and event snippet pair for a TrackingCodeType.",
      "type": "object",
      "properties": {
        "type": {
          "description": "The type of the generated tag snippets for tracking conversions.",
          "type": "string",
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "The snippet that is fired as a result of a website page loading.",
            "The snippet contains a JavaScript function which fires the tag. This function is typically called from an onClick handler added to a link or button element on the page.",
            "For embedding on a mobile webpage. The snippet contains a JavaScript function which fires the tag.",
            "The snippet that is used to replace the phone number on your website with a Google forwarding number for call tracking purposes."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "WEBPAGE",
            "WEBPAGE_ONCLICK",
            "CLICK_TO_CALL",
            "WEBSITE_CALL"
          ]
        },
        "pageFormat": {
          "type": "string",
          "description": "The format of the web page where the tracking tag and snippet will be installed, for example, HTML.",
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "Standard HTML page format.",
            "Google AMP page format."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "HTML",
            "AMP"
          ]
        },
        "globalSiteTag": {
          "description": "The site tag that adds visitors to your basic remarketing lists and sets new cookies on your domain.",
          "type": "string"
        },
        "eventSnippet": {
          "type": "string",
          "description": "The event snippet that works with the site tag to track actions that should be counted as conversions."
        }
      }
    },
    "GoogleAdsGoogleadsV25Resources__RemarketingAction": {
      "description": "A remarketing action. A snippet of JavaScript code that will collect the product id and the type of page people visited (product page, shopping cart page, purchase page, general site visit) on an advertiser's website.",
      "type": "object",
      "properties": {
        "id": {
          "description": "Output only. Id of the remarketing action.",
          "type": "string",
          "format": "int64"
        },
        "name": {
          "type": "string",
          "description": "The name of the remarketing action. This field is required and should not be empty when creating new remarketing actions."
        },
        "resourceName": {
          "type": "string",
          "description": "Immutable. The resource name of the remarketing action. Remarketing action resource names have the form: `customers/{customer_id}/remarketingActions/{remarketing_action_id}`"
        },
        "tagSnippets": {
          "description": "Output only. The snippets used for tracking remarketing actions.",
          "items": {
            "$ref": "#/$defs/GoogleAdsGoogleadsV25Common__TagSnippet"
          },
          "type": "array"
        }
      }
    },
    "GoogleAdsGoogleadsV25Services__RemarketingActionOperation": {
      "type": "object",
      "properties": {
        "update": {
          "description": "Update operation: The remarketing action is expected to have a valid resource name.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__RemarketingAction"
        },
        "updateMask": {
          "description": "FieldMask that determines which resource fields are modified in an update.",
          "type": "string",
          "format": "google-fieldmask"
        },
        "create": {
          "description": "Create operation: No resource name is expected for the new remarketing action.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__RemarketingAction"
        }
      },
      "description": "A single operation (create, update) on a remarketing action."
    }
  }
}