GoogleAdsGoogleadsV25Services__MutateSmartCampaignSettingsRequest

{
  "$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-smart-campaign-settings-request-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__MutateSmartCampaignSettingsRequest",
  "description": "Request message for SmartCampaignSettingService.MutateSmartCampaignSettings.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-customers-smartcampaignsettings-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__MutateSmartCampaignSettingsRequest",
  "type": "object",
  "properties": {
    "operations": {
      "description": "Required. The list of operations to perform on individual Smart campaign settings.",
      "items": {
        "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__SmartCampaignSettingOperation"
      },
      "type": "array"
    },
    "validateOnly": {
      "type": "boolean",
      "description": "If true, the request is validated but not executed. Only errors are returned, not results."
    },
    "responseContentType": {
      "type": "string",
      "description": "The response content type setting. Determines whether the mutable resource or just the resource name should be returned post mutation.",
      "x-enumDescriptions": [
        "Not specified. Will return the resource name only in the response.",
        "The mutate response will be the resource name.",
        "The mutate response will contain the resource name and the resource with mutable fields if possible. Otherwise, only the resource name will be returned."
      ],
      "enum": [
        "UNSPECIFIED",
        "RESOURCE_NAME_ONLY",
        "MUTABLE_RESOURCE"
      ]
    },
    "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_SmartCampaignSetting_AdOptimizedBusinessProfileSetting": {
      "description": "Settings for configuring a business profile optimized for ads as this campaign's landing page.",
      "type": "object",
      "properties": {
        "includeLeadForm": {
          "type": "boolean",
          "description": "Enabling a lead form on your business profile enables prospective customers to contact your business by filling out a simple form, and you'll receive their information through email."
        }
      }
    },
    "GoogleAdsGoogleadsV25Resources_SmartCampaignSetting_PhoneNumber": {
      "description": "Phone number and country code in smart campaign settings.",
      "type": "object",
      "properties": {
        "phoneNumber": {
          "type": "string",
          "description": "Phone number of the smart campaign."
        },
        "countryCode": {
          "description": "Upper-case, two-letter country code as defined by ISO-3166.",
          "type": "string"
        }
      }
    },
    "GoogleAdsGoogleadsV25Resources__SmartCampaignSetting": {
      "description": "Settings for configuring Smart campaigns.",
      "type": "object",
      "properties": {
        "advertisingLanguageCode": {
          "description": "The language code to advertise in from the set of [supported language codes] (https://developers.google.com/google-ads/api/reference/data/codes-formats#languages).",
          "type": "string"
        },
        "businessName": {
          "type": "string",
          "description": "The name of the business."
        },
        "phoneNumber": {
          "description": "Phone number and country code.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources_SmartCampaignSetting_PhoneNumber"
        },
        "finalUrl": {
          "type": "string",
          "description": "The user-provided landing page URL for this Campaign."
        },
        "campaign": {
          "type": "string",
          "description": "Output only. The campaign to which these settings apply."
        },
        "businessProfileLocation": {
          "type": "string",
          "description": "The resource name of a Business Profile location. Business Profile location resource names can be fetched through the Business Profile API and adhere to the following format: `locations/{locationId}`. See the [Business Profile API] (https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations) for additional details."
        },
        "resourceName": {
          "description": "Immutable. The resource name of the Smart campaign setting. Smart campaign setting resource names have the form: `customers/{customer_id}/smartCampaignSettings/{campaign_id}`",
          "type": "string"
        },
        "adOptimizedBusinessProfileSetting": {
          "description": "Settings for configuring a business profile optimized for ads as this campaign's landing page. This campaign must be linked to a business profile to use this option. For more information on this feature, consult https://support.google.com/google-ads/answer/9827068.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources_SmartCampaignSetting_AdOptimizedBusinessProfileSetting"
        }
      }
    },
    "GoogleAdsGoogleadsV25Services__SmartCampaignSettingOperation": {
      "description": "A single operation to update Smart campaign settings for a campaign.",
      "type": "object",
      "properties": {
        "updateMask": {
          "type": "string",
          "description": "FieldMask that determines which resource fields are modified in an update.",
          "format": "google-fieldmask"
        },
        "update": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__SmartCampaignSetting",
          "description": "Update operation: The Smart campaign setting must specify a valid resource name."
        }
      }
    }
  }
}