AI Max in v21

[Xiaoyu Liu]

Hi Google Ads team,

I have a question about which API field controls the following two checkboxes under AI Max at the campaign level.

My understanding is that FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION in AssetAutomationType controls both checkboxes. However, what if I want to turn off only the "Final URL (Beta)" option? I noticed there is a field called url_expansion_opt_out, but it appears to apply only to Performance Max campaigns.

So, if we want to disable only the "Final URL (Beta)" option via the API, which specific field controls these two checkboxes?

Best,
Xiaoyu

[Xiaoyu Liu]

Hi team,

Any update here ?

I looked into Google doc again, and I think FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION controls both check box because the second one depends on the first one. If we onlt want to turn on the first one (Text Customization), it will be TEXT_ASSET_AUTOMATION, correct ?

Thanks,
Xiaoyu

[Xiaoyu Liu]

team, any updates here ?

On Thursday, August 21, 2025 at 8:41:29 PM UTC-7 Xiaoyu Liu wrote:

[Google Ads API and AdWords API Forum]

Hi,

Thank you for reaching out to the Google Ads API support team.

Based on the provided information, I understand that you are looking for guidance on Google Ads API to manage your campaigns and utilize the AI Max features, specifically Text Asset Automation and Final URL Expansion. First, you must enable AI Max for your campaign by setting the ai_max_setting.enable_ai_max field to true. If you try to enable any of the other AI Max features without doing this first, you will get a CampaignError.AI_MAX_MUST_BE_ENABLED error.

After enabling AI Max, you can manage both Text Asset Automation and Final URL Expansion through the AssetAutomationTypeEnum. These two features are managed together by a single setting.

Here's how each setting works:

• FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION controls the automation of both dynamic landing pages and text assets created from the content of those pages. This setting is only for Search campaigns, and you are opted out by default.
• TEXT_ASSET_AUTOMATION manages the automation of headlines and descriptions. For Performance Max campaigns, you are opted in by default, while for Search campaigns, you are opted out by default.

I can confirm that your understanding is correct. If you want to opt in for Text Customization only, you should use `AssetAutomationSetting` of type `TEXT_ASSET_AUTOMATION` and set `AssetAutomationStatus` to `OPTED_IN`.

And if you want to opt in for Final URL Expansion, since Text Customization is a prerequisite for Final URL Expansion, you should use `AssetAutomationSetting` of type `FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION` and set `AssetAutomationStatus` to `OPTED_IN`.

Hope this helps. If you have any more queries, please feel free to get back to us.

Regards,

Google Ads API Team.

[Xiaoyu Liu]

Thank you for the detailed response!

One question is can I enable AI Max and setup Text Asset Automation and Final URL Expansion in one API call ? Or I have to enable AI Max first then enable both settings?

[Google Ads API and AdWords API Forum]

Hi,

It's not possible to enable all three in a single API call. If you attempt to opt into ' FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION' without first enabling AI Max for Search campaigns, you will encounter a 'CampaignError.AI_MAX_MUST_BE_ENABLED' error. This indicates that these actions need to be performed sequentially rather than in one atomic operation.

[Google Ads API and AdWords API Forum]

Hi,

To use the 'Final URL expansion' setting in the UI, 'Text customization' must be enabled. Turning off 'Text customization' will also turn off 'Final URL expansion'. In this case, all three features (AI Max, Asset Customization, and Final URL) will be enabled simultaneously in UI. From the provided logs, it appears that you have performed the same operation. This means you can enable ai_max_setting.enable_ai_max field and OPTIN for 'FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION' in single request.

Hope this answers your query. If you have any more queries, please feel free to get back to us.

Regards,

Google Ads API Team.