--- title: "POST /v23/customers/{+customerId}/adGroups:mutate" method: POST path: "/v23/customers/{+customerId}/adGroups:mutate" tags: ["customers"] --- # POST /v23/customers/{+customerId}/adGroups:mutate `POST /v23/customers/{+customerId}/adGroups:mutate` Creates, updates, or removes ad groups. Operation statuses are returned. List of thrown errors: [AdGroupError]() [AdxError]() [AuthenticationError]() [AuthorizationError]() [BiddingError]() [BiddingStrategyError]() [DatabaseError]() [DateError]() [DistinctError]() [FieldError]() [FieldMaskError]() [HeaderError]() [IdError]() [InternalError]() [ListOperationError]() [MultiplierError]() [MutateError]() [NewResourceCreationError]() [NotEmptyError]() [NullError]() [OperationAccessDeniedError]() [OperatorError]() [QuotaError]() [RangeError]() [RequestError]() [ResourceCountLimitExceededError]() [SettingError]() [SizeLimitError]() [StringFormatError]() [StringLengthError]() [UrlFieldError]() ## Path parameters - `customerId` string, required ## Request body - GoogleAdsSearchads360V23ServicesMutateAdGroupsRequest — Request message for AdGroupService.MutateAdGroups. - `operations` GoogleAdsSearchads360V23ServicesAdGroupOperation[] — Required. The list of operations to perform on individual ad groups. - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `remove` string — Remove operation: A resource name for the removed ad group is expected, in this format: `customers/{customer_id}/adGroups/{ad_group_id}` - `create` GoogleAdsSearchads360V23ResourcesAdGroup — An ad group. - `effectiveTargetCpcSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target CPC. This field is read-only. - `engineId` string — Output only. ID of the ad group in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group.id" instead. - `effectiveTargetCpaSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target CPA. This field is read-only. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'SEARCH_STANDARD' | 'DISPLAY_STANDARD' | 'SHOPPING_PRODUCT_ADS' | 'HOTEL_ADS' | 'SHOPPING_SMART_ADS' | 'VIDEO_BUMPER' | 'VIDEO_TRUE_VIEW_IN_STREAM' | 'VIDEO_TRUE_VIEW_IN_DISPLAY' | 'VIDEO_NON_SKIPPABLE_IN_STREAM' | 'SEARCH_DYNAMIC_ADS' | 'SHOPPING_COMPARISON_LISTING_ADS' | 'PROMOTED_HOTEL_ADS' | 'VIDEO_RESPONSIVE' | 'VIDEO_EFFICIENT_REACH' | 'SMART_CAMPAIGN_ADS' | 'TRAVEL_ADS' — Immutable. The type of the ad group. - `targetCpvMicros` string, int64 — Average amount in micros that the advertiser is willing to pay for every ad view. - `baseAdGroup` string — Output only. For draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only. - `startDate` string — Output only. Date when this ad group starts serving ads. By default, the ad group starts now or the ad group's start date, whichever is later. If this field is set, then the ad group starts at the beginning of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14 - `targetCpcMicros` string, int64 — Average amount in micros that the advertiser is willing to pay for every ad click. Overrides the target CPC configured at the campaign level. - `targetingSetting` GoogleAdsSearchads360V23CommonTargetingSetting — Settings for the targeting-related features, at the campaign and ad group levels. For more details about the targeting setting, visit https://support.google.com/google-ads/answer/7365594 - `targetRestrictions` GoogleAdsSearchads360V23CommonTargetRestriction[] — The per-targeting-dimension setting to restrict the reach of your campaign or ad group. - `bidOnly` boolean — Indicates whether to restrict your ads to show only for the criteria you have selected for this targeting_dimension, or to target all values for this targeting_dimension and show ads based on your targeting in other TargetingDimensions. A value of `true` means that these criteria will only apply bid modifiers, and not affect targeting. A value of `false` means that these criteria will restrict targeting as well as applying bid modifiers. - `targetingDimension` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'AUDIENCE' | 'TOPIC' | 'GENDER' | 'AGE_RANGE' | 'PLACEMENT' | 'PARENTAL_STATUS' | 'INCOME_RANGE' — The targeting dimension that these settings apply to. - `targetRestrictionOperations` GoogleAdsSearchads360V23CommonTargetRestrictionOperation[] — The list of operations changing the target restrictions. Adding a target restriction with a targeting dimension that already exists causes the existing target restriction to be replaced with the new value. - `operator` 'UNSPECIFIED' | 'UNKNOWN' | 'ADD' | 'REMOVE' — Type of list operation to perform. - `value` GoogleAdsSearchads360V23CommonTargetRestriction — The list of per-targeting-dimension targeting settings. - `bidOnly` boolean — Indicates whether to restrict your ads to show only for the criteria you have selected for this targeting_dimension, or to target all values for this targeting_dimension and show ads based on your targeting in other TargetingDimensions. A value of `true` means that these criteria will only apply bid modifiers, and not affect targeting. A value of `false` means that these criteria will restrict targeting as well as applying bid modifiers. - `targetingDimension` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'AUDIENCE' | 'TOPIC' | 'GENDER' | 'AGE_RANGE' | 'PLACEMENT' | 'PARENTAL_STATUS' | 'INCOME_RANGE' — The targeting dimension that these settings apply to. - `effectiveTargetCpaMicros` string, int64 — Output only. The effective target CPA (cost-per-acquisition). This field is read-only. - `cpcBidMicros` string, int64 — The maximum CPC (cost-per-click) bid. This field is used when the ad group's effective bidding strategy is Manual CPC. This field is not applicable and will be ignored if the ad group's campaign is using a portfolio bidding strategy. - `demandGenAdGroupSettings` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettings — Settings for Demand Gen ad groups. - `channelControls` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettingsDemandGenChannelControls — Channel controls for Demand Gen ad groups. - `channelConfig` 'UNSPECIFIED' | 'UNKNOWN' | 'CHANNEL_STRATEGY' | 'SELECTED_CHANNELS' — Output only. Channel configuration reflecting which field in the oneof is populated. - `channelStrategy` 'UNSPECIFIED' | 'UNKNOWN' | 'ALL_CHANNELS' | 'ALL_OWNED_AND_OPERATED_CHANNELS' — High level channel strategy. - `selectedChannels` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettingsDemandGenChannelControlsDemandGenSelectedChannels — Explicitly selected channels for channel controls in Demand Gen ad groups. - `youtubeInFeed` boolean — Whether to enable ads on the YouTube In-Feed channel. - `gmail` boolean — Whether to enable ads on the Gmail channel. - `discover` boolean — Whether to enable ads on the Discover channel. - `display` boolean — Whether to enable ads on the Display channel. - `youtubeInStream` boolean — Whether to enable ads on the YouTube In-Stream channel. - `youtubeShorts` boolean — Whether to enable ads on the YouTube Shorts channel. - `name` string — The name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. - `effectiveTargetRoasSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target ROAS. This field is read-only. - `effectiveTargetCpc` string, int64 — Output only. The effective target CPC (cost-per-click). This field is read-only. - `primaryStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'NOT_ELIGIBLE' | 'LIMITED' — Output only. Provides aggregated view into why an ad group is not serving or not serving optimally. - `engineStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_GROUP_ELIGIBLE' | 'AD_GROUP_EXPIRED' | 'AD_GROUP_REMOVED' | 'AD_GROUP_DRAFT' | 'AD_GROUP_PAUSED' | 'AD_GROUP_SERVING' | 'AD_GROUP_SUBMITTED' | 'CAMPAIGN_PAUSED' | 'ACCOUNT_PAUSED' — Output only. The Engine Status for ad group. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'PAUSED' | 'REMOVED' — The status of the ad group. - `trackingUrlTemplate` string — The URL template for constructing a tracking URL. - `effectiveTargetRoas` number, double — Output only. The effective target ROAS (return-on-ad-spend). This field is read-only. - `excludedParentAssetFieldTypes` string[] — The asset field types that should be excluded from this ad group. Asset links with these field types will not be inherited by this ad group from the upper levels. - `excludeDemographicExpansion` boolean — When this value is true, demographics will be excluded from the types of targeting which are expanded when optimized_targeting_enabled is true. When optimized_targeting_enabled is false, this field is ignored. Default is false. - `effectiveLabels` string[] — Output only. The resource names of effective labels attached to this ad group. An effective label is a label inherited or directly assigned to this ad group. - `audienceSetting` GoogleAdsSearchads360V23ResourcesAdGroupAudienceSetting — Settings for the audience targeting. - `useAudienceGrouped` boolean — Immutable. If true, this ad group uses an Audience resource for audience targeting. If false, this ad group may use audience segment criteria instead. - `targetCpaMicros` string, int64 — The target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored. - `fixedCpmMicros` string, int64 — The fixed amount in micros that the advertiser pays for every thousand impressions of the ad. - `optimizedTargetingEnabled` boolean — True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion. - `targetRoas` number, double — The target ROAS (return-on-ad-spend) for this ad group. This field lets you override the target ROAS specified in the campaign's bidding strategy, but only if the campaign is using a standard (not portfolio) `TargetRoas` strategy or a standard `MaximizeConversionValue` strategy with its `target_roas` field set. If the campaign is using a portfolio bidding strategy, this field cannot be set and attempting to do so will result in an error. For any other bidding strategies, this value is ignored. To see the actual target ROAS being used by the ad group, considering potential overrides, query the `effective_target_roas` and `effective_target_roas_source` fields. - `aiMaxAdGroupSetting` GoogleAdsSearchads360V23ResourcesAdGroupAiMaxAdGroupSetting — Settings for AI Max feature in standard search adgroups. - `disableSearchTermMatching` boolean — Disable search term matching for this adgroup when AI Max is enabled. Search term matching uses broad match, asset-based, and landing page-based technology to improve reach. - `excludedParentAssetSetTypes` string[] — The asset set types that should be excluded from this ad group. Asset set links with these types will not be inherited by this ad group from the upper levels. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this ad group, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this ad group. Only LOCATION_SYNC is currently supported. - `urlCustomParameters` GoogleAdsSearchads360V23CommonCustomParameter[] — The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`. - `key` string — The key matching the parameter tag name. - `value` string — The value to be substituted. - `languageCode` string — Output only. The language of the ads and keywords in an ad group. This field is only available for Microsoft Advertising accounts. More details: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage - `finalUrlSuffix` string — URL template for appending params to Final URL. - `cpmBidMicros` string, int64 — The maximum CPM (cost-per-thousand viewable impressions) bid. - `verticalAdsFormatSetting` GoogleAdsSearchads360V23ResourcesAdGroupVerticalAdsFormatSetting — Vertical ads setting feature to enable/disable ad group format controls in search campaigns. - `enableVerticalPromotionAds` boolean — If true, vertical promotion ads will be enabled for this ad group. - `disableTextAds` boolean — If true, text ads will be disabled for this ad group. - `enableBookingLinks` boolean — If true, booking links will be enabled for this ad group. - `lastModifiedTime` string — Output only. The datetime when this ad group was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format. - `primaryStatusReasons` string[] — Output only. Provides reasons for why an ad group is not serving or not serving optimally. - `id` string, int64 — Output only. The ID of the ad group. - `percentCpcBidMicros` string, int64 — The percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction]. - `endDate` string — Output only. Date when the ad group ends serving ads. By default, the ad group ends on the ad group's end date. If this field is set, then the ad group ends at the end of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14 - `targetCpmMicros` string, int64 — Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown. - `resourceName` string — Immutable. The resource name of the ad group. Ad group resource names have the form: `customers/{customer_id}/adGroups/{ad_group_id}` - `cpvBidMicros` string, int64 — The CPV (cost-per-view) bid. - `campaign` string — Immutable. The campaign to which the ad group belongs. - `displayCustomBidDimension` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'AUDIENCE' | 'TOPIC' | 'GENDER' | 'AGE_RANGE' | 'PLACEMENT' | 'PARENTAL_STATUS' | 'INCOME_RANGE' — Lets advertisers specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search. - `labels` string[] — Output only. The resource names of labels attached to this ad group. - `effectiveCpcBidMicros` string, int64 — Output only. Value will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null. - `creationTime` string — Output only. The timestamp when this ad_group was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. - `adRotationMode` 'UNSPECIFIED' | 'UNKNOWN' | 'OPTIMIZE' | 'ROTATE_FOREVER' — The ad rotation mode of the ad group. - `update` GoogleAdsSearchads360V23ResourcesAdGroup — An ad group. - `effectiveTargetCpcSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target CPC. This field is read-only. - `engineId` string — Output only. ID of the ad group in the external engine account. This field is for non-Google Ads account only, for example, Yahoo Japan, Microsoft, Baidu etc. For Google Ads entity, use "ad_group.id" instead. - `effectiveTargetCpaSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target CPA. This field is read-only. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'SEARCH_STANDARD' | 'DISPLAY_STANDARD' | 'SHOPPING_PRODUCT_ADS' | 'HOTEL_ADS' | 'SHOPPING_SMART_ADS' | 'VIDEO_BUMPER' | 'VIDEO_TRUE_VIEW_IN_STREAM' | 'VIDEO_TRUE_VIEW_IN_DISPLAY' | 'VIDEO_NON_SKIPPABLE_IN_STREAM' | 'SEARCH_DYNAMIC_ADS' | 'SHOPPING_COMPARISON_LISTING_ADS' | 'PROMOTED_HOTEL_ADS' | 'VIDEO_RESPONSIVE' | 'VIDEO_EFFICIENT_REACH' | 'SMART_CAMPAIGN_ADS' | 'TRAVEL_ADS' — Immutable. The type of the ad group. - `targetCpvMicros` string, int64 — Average amount in micros that the advertiser is willing to pay for every ad view. - `baseAdGroup` string — Output only. For draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only. - `startDate` string — Output only. Date when this ad group starts serving ads. By default, the ad group starts now or the ad group's start date, whichever is later. If this field is set, then the ad group starts at the beginning of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14 - `targetCpcMicros` string, int64 — Average amount in micros that the advertiser is willing to pay for every ad click. Overrides the target CPC configured at the campaign level. - `targetingSetting` GoogleAdsSearchads360V23CommonTargetingSetting — Settings for the targeting-related features, at the campaign and ad group levels. For more details about the targeting setting, visit https://support.google.com/google-ads/answer/7365594 - `targetRestrictions` GoogleAdsSearchads360V23CommonTargetRestriction[] — The per-targeting-dimension setting to restrict the reach of your campaign or ad group. - `bidOnly` boolean — Indicates whether to restrict your ads to show only for the criteria you have selected for this targeting_dimension, or to target all values for this targeting_dimension and show ads based on your targeting in other TargetingDimensions. A value of `true` means that these criteria will only apply bid modifiers, and not affect targeting. A value of `false` means that these criteria will restrict targeting as well as applying bid modifiers. - `targetingDimension` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'AUDIENCE' | 'TOPIC' | 'GENDER' | 'AGE_RANGE' | 'PLACEMENT' | 'PARENTAL_STATUS' | 'INCOME_RANGE' — The targeting dimension that these settings apply to. - `targetRestrictionOperations` GoogleAdsSearchads360V23CommonTargetRestrictionOperation[] — The list of operations changing the target restrictions. Adding a target restriction with a targeting dimension that already exists causes the existing target restriction to be replaced with the new value. - `operator` 'UNSPECIFIED' | 'UNKNOWN' | 'ADD' | 'REMOVE' — Type of list operation to perform. - `value` GoogleAdsSearchads360V23CommonTargetRestriction — The list of per-targeting-dimension targeting settings. - `bidOnly` boolean — Indicates whether to restrict your ads to show only for the criteria you have selected for this targeting_dimension, or to target all values for this targeting_dimension and show ads based on your targeting in other TargetingDimensions. A value of `true` means that these criteria will only apply bid modifiers, and not affect targeting. A value of `false` means that these criteria will restrict targeting as well as applying bid modifiers. - `targetingDimension` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'AUDIENCE' | 'TOPIC' | 'GENDER' | 'AGE_RANGE' | 'PLACEMENT' | 'PARENTAL_STATUS' | 'INCOME_RANGE' — The targeting dimension that these settings apply to. - `effectiveTargetCpaMicros` string, int64 — Output only. The effective target CPA (cost-per-acquisition). This field is read-only. - `cpcBidMicros` string, int64 — The maximum CPC (cost-per-click) bid. This field is used when the ad group's effective bidding strategy is Manual CPC. This field is not applicable and will be ignored if the ad group's campaign is using a portfolio bidding strategy. - `demandGenAdGroupSettings` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettings — Settings for Demand Gen ad groups. - `channelControls` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettingsDemandGenChannelControls — Channel controls for Demand Gen ad groups. - `channelConfig` 'UNSPECIFIED' | 'UNKNOWN' | 'CHANNEL_STRATEGY' | 'SELECTED_CHANNELS' — Output only. Channel configuration reflecting which field in the oneof is populated. - `channelStrategy` 'UNSPECIFIED' | 'UNKNOWN' | 'ALL_CHANNELS' | 'ALL_OWNED_AND_OPERATED_CHANNELS' — High level channel strategy. - `selectedChannels` GoogleAdsSearchads360V23ResourcesAdGroupDemandGenAdGroupSettingsDemandGenChannelControlsDemandGenSelectedChannels — Explicitly selected channels for channel controls in Demand Gen ad groups. - `youtubeInFeed` boolean — Whether to enable ads on the YouTube In-Feed channel. - `gmail` boolean — Whether to enable ads on the Gmail channel. - `discover` boolean — Whether to enable ads on the Discover channel. - `display` boolean — Whether to enable ads on the Display channel. - `youtubeInStream` boolean — Whether to enable ads on the YouTube In-Stream channel. - `youtubeShorts` boolean — Whether to enable ads on the YouTube Shorts channel. - `name` string — The name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. - `effectiveTargetRoasSource` 'UNSPECIFIED' | 'UNKNOWN' | 'CAMPAIGN_BIDDING_STRATEGY' | 'AD_GROUP' | 'AD_GROUP_CRITERION' — Output only. Source of the effective target ROAS. This field is read-only. - `effectiveTargetCpc` string, int64 — Output only. The effective target CPC (cost-per-click). This field is read-only. - `primaryStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'ELIGIBLE' | 'PAUSED' | 'REMOVED' | 'PENDING' | 'NOT_ELIGIBLE' | 'LIMITED' — Output only. Provides aggregated view into why an ad group is not serving or not serving optimally. - `engineStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_GROUP_ELIGIBLE' | 'AD_GROUP_EXPIRED' | 'AD_GROUP_REMOVED' | 'AD_GROUP_DRAFT' | 'AD_GROUP_PAUSED' | 'AD_GROUP_SERVING' | 'AD_GROUP_SUBMITTED' | 'CAMPAIGN_PAUSED' | 'ACCOUNT_PAUSED' — Output only. The Engine Status for ad group. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'PAUSED' | 'REMOVED' — The status of the ad group. - `trackingUrlTemplate` string — The URL template for constructing a tracking URL. - `effectiveTargetRoas` number, double — Output only. The effective target ROAS (return-on-ad-spend). This field is read-only. - `excludedParentAssetFieldTypes` string[] — The asset field types that should be excluded from this ad group. Asset links with these field types will not be inherited by this ad group from the upper levels. - `excludeDemographicExpansion` boolean — When this value is true, demographics will be excluded from the types of targeting which are expanded when optimized_targeting_enabled is true. When optimized_targeting_enabled is false, this field is ignored. Default is false. - `effectiveLabels` string[] — Output only. The resource names of effective labels attached to this ad group. An effective label is a label inherited or directly assigned to this ad group. - `audienceSetting` GoogleAdsSearchads360V23ResourcesAdGroupAudienceSetting — Settings for the audience targeting. - `useAudienceGrouped` boolean — Immutable. If true, this ad group uses an Audience resource for audience targeting. If false, this ad group may use audience segment criteria instead. - `targetCpaMicros` string, int64 — The target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored. - `fixedCpmMicros` string, int64 — The fixed amount in micros that the advertiser pays for every thousand impressions of the ad. - `optimizedTargetingEnabled` boolean — True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion. - `targetRoas` number, double — The target ROAS (return-on-ad-spend) for this ad group. This field lets you override the target ROAS specified in the campaign's bidding strategy, but only if the campaign is using a standard (not portfolio) `TargetRoas` strategy or a standard `MaximizeConversionValue` strategy with its `target_roas` field set. If the campaign is using a portfolio bidding strategy, this field cannot be set and attempting to do so will result in an error. For any other bidding strategies, this value is ignored. To see the actual target ROAS being used by the ad group, considering potential overrides, query the `effective_target_roas` and `effective_target_roas_source` fields. - `aiMaxAdGroupSetting` GoogleAdsSearchads360V23ResourcesAdGroupAiMaxAdGroupSetting — Settings for AI Max feature in standard search adgroups. - `disableSearchTermMatching` boolean — Disable search term matching for this adgroup when AI Max is enabled. Search term matching uses broad match, asset-based, and landing page-based technology to improve reach. - `excludedParentAssetSetTypes` string[] — The asset set types that should be excluded from this ad group. Asset set links with these types will not be inherited by this ad group from the upper levels. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this ad group, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this ad group. Only LOCATION_SYNC is currently supported. - `urlCustomParameters` GoogleAdsSearchads360V23CommonCustomParameter[] — The list of mappings used to substitute custom parameter tags in a `tracking_url_template`, `final_urls`, or `mobile_final_urls`. - `key` string — The key matching the parameter tag name. - `value` string — The value to be substituted. - `languageCode` string — Output only. The language of the ads and keywords in an ad group. This field is only available for Microsoft Advertising accounts. More details: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage - `finalUrlSuffix` string — URL template for appending params to Final URL. - `cpmBidMicros` string, int64 — The maximum CPM (cost-per-thousand viewable impressions) bid. - `verticalAdsFormatSetting` GoogleAdsSearchads360V23ResourcesAdGroupVerticalAdsFormatSetting — Vertical ads setting feature to enable/disable ad group format controls in search campaigns. - `enableVerticalPromotionAds` boolean — If true, vertical promotion ads will be enabled for this ad group. - `disableTextAds` boolean — If true, text ads will be disabled for this ad group. - `enableBookingLinks` boolean — If true, booking links will be enabled for this ad group. - `lastModifiedTime` string — Output only. The datetime when this ad group was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format. - `primaryStatusReasons` string[] — Output only. Provides reasons for why an ad group is not serving or not serving optimally. - `id` string, int64 — Output only. The ID of the ad group. - `percentCpcBidMicros` string, int64 — The percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction]. - `endDate` string — Output only. Date when the ad group ends serving ads. By default, the ad group ends on the ad group's end date. If this field is set, then the ad group ends at the end of the specified date in the customer's time zone. This field is only available for Microsoft Advertising and Facebook gateway accounts. Format: YYYY-MM-DD Example: 2019-03-14 - `targetCpmMicros` string, int64 — Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown. - `resourceName` string — Immutable. The resource name of the ad group. Ad group resource names have the form: `customers/{customer_id}/adGroups/{ad_group_id}` - `cpvBidMicros` string, int64 — The CPV (cost-per-view) bid. - `campaign` string — Immutable. The campaign to which the ad group belongs. - `displayCustomBidDimension` 'UNSPECIFIED' | 'UNKNOWN' | 'KEYWORD' | 'AUDIENCE' | 'TOPIC' | 'GENDER' | 'AGE_RANGE' | 'PLACEMENT' | 'PARENTAL_STATUS' | 'INCOME_RANGE' — Lets advertisers specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search. - `labels` string[] — Output only. The resource names of labels attached to this ad group. - `effectiveCpcBidMicros` string, int64 — Output only. Value will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null. - `creationTime` string — Output only. The timestamp when this ad_group was created. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. - `adRotationMode` 'UNSPECIFIED' | 'UNKNOWN' | 'OPTIMIZE' | 'ROTATE_FOREVER' — The ad rotation mode of the ad group. - `responseContentType` 'UNSPECIFIED' | 'RESOURCE_NAME_ONLY' | 'MUTABLE_RESOURCE' — The response content type setting. Determines whether the mutable resource or just the resource name should be returned post mutation. - `validateOnly` boolean — If true, the request is validated but not executed. Only errors are returned, not results. - `partialFailure` boolean — 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. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/versions/40d087435afd/schema)