View as Markdown
Google Ads icon

Google Ads ACTION

Update Campaign AI Max Settings

Enables or configures AI Max for Search settings on a campaign. Only supported on Search campaigns. Toggling AI Max while simultaneously editing brand or text customization settings on the same campaign may fail — update them separately. Ad group-level search term matching is controlled via the Create or Update Ad Group action. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Google Ads account once, then configure and run Update Campaign AI Max Settings from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "google_ads-update-campaign-ai-max-settings",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    google_ads: { authProvisionId: "apn_xxxxxxx" },
    accountId: "Use Google Ads As",
    customerClientId: "Managed Account",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Update Campaign AI Max Settings inputs
Property Type Description
accountId Use Google Ads As string
The ID of an account of a customer directly accessible by the authenticated user. This is usually a Manager Account, used as login-customer-id (e.g., 1234567890). Use the List Account ID Options action to get the list of accessible accounts.
Required Dynamic
customerClientId Managed Account string
The ID of a customer client from the list of customers linked to the selected account (e.g., 1234567890). Use the List Customer Clients action to get the list of customer clients.
Optional Dynamic
campaignId Campaign string
Numeric campaign ID (e.g., 1234567890). Use the List Campaigns action to discover valid IDs.
Required Dynamic
enableAiMax Enable AI Max boolean
Whether to enable AI Max for Search on this campaign (aiMaxSetting.enableAiMax).
Optional
bundlingRequired Bundling Required boolean
Whether bundling is required for AI Max asset serving (aiMaxSetting.bundlingRequired).
Optional
textAssetAutomation Text Asset Automation string
Opt in or out of automatically generated text assets (TEXT_ASSET_AUTOMATION).
Optional
finalUrlExpansionAutomation Final URL Expansion Automation string
Opt in or out of automatically expanding final URLs (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION).
Optional
additionalFields Additional Fields object
Additional fields and values to be created. See the documentation for available fields. Values will be parsed as JSON where applicable.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
google_ads-update-campaign-ai-max-settings
Version
0.0.3
App
Google Ads
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes