> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Ads

> Google Ads, is an online advertising platform developed by Google, where advertisers bid to display brief advertisements, service offerings, product listings, and videos to web users.

![Google Ads logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/googleads.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=55fbb28143e4c4b6e98c2819d8ce08ef)

* **Category:** ads & conversion
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 78
* **Triggers:** 0
* **Slug:** `GOOGLEADS`
* **Version:** 20261101\_00

## Frequently Asked Questions

> [accordion] Google Ads developer token now belongs on the auth config, not connection initiation
>
> Google Ads was changed so the developer token lives on the auth config itself, not on each connection initiation request. Older auth configs created before this change do not have the developer token field, and new connections through those auth configs can fail because the token is no longer accepted at the connection level. Create a new Google Ads authConfig with the developer token included, then create a fresh connection through that authConfig.
>
> ![Google Ads auth config form showing the developer token field under custom developer credentials.](https://mintcdn.com/composio-preview/cL3pOAF8H-TYHF1S/images/kb/toolkits/googleads/google-ads-developer-token-auth-config.png?fit=max\&auto=format\&n=cL3pOAF8H-TYHF1S\&q=85\&s=506a20b0a8dfb8366ff874445749ce84)

> [accordion] What can cause Google Ads 429s?
>
> A Google Ads 429 / `RESOURCE_EXHAUSTED` is an upstream Google Ads API limit, not a Composio billing-plan or tool-call quota. Google Ads enforces limits on the underlying developer token, account, request pattern, service, and resource usage.
>
> This can happen with Composio-managed credentials or with custom Google Ads credentials. Reduce request volume, add backoff, simplify expensive queries, and use an owned Google Ads OAuth app/developer token for production isolation where possible.

> [accordion] Google Ads MCC/sub-account targeting
>
> For Google Ads manager-account (MCC) setups, `GOOGLEADS_LIST_ACCESSIBLE_CUSTOMERS` can succeed while GAQL/reporting or campaign calls against a child account fail. Two common Google errors are:
>
> * 403 `USER_PERMISSION_DENIED` with guidance that, when accessing a client customer, the manager customer ID must be set in the `login-customer-id` header.
> * `REQUESTED_METRICS_FOR_MANAGER` when metric fields are queried directly from the MCC manager account instead of a child/customer account.
>
> Treat this as MCC targeting/account-context, not OAuth. Reconnecting alone does not fix it unless the user had connected the wrong account context.
>
> Correct call shape:
>
> * target child/customer account ID in the request path, for example `/customers/{child_customer_id}/googleAds:searchStream`
> * manager/MCC customer ID in the `login-customer-id` header

> [accordion] Google Ads OAuth callback token-exchange failures usually point to bad credentials
>
> The `OAuth callback failed during token exchange` error usually means the credentials used to complete the auth flow are incorrect, most often the client secret. Re-enter or update the client secret in the Google Ads auth config, make sure there are no leading/trailing spaces, and initiate a new connection.

> [accordion] What do custom Google OAuth apps need for white-label consent?
>
> For Google toolkits, creating a new authConfig with the user's OAuth app credentials is not enough for full white-label consent. They also need to route the callback through their own domain using their own redirect URI so Google displays the configured consent screen for that OAuth app.

## Tools

> [accordion] Add or remove to customer list
>
> **Slug:** `GOOGLEADS_ADD_OR_REMOVE_TO_CUSTOMER_LIST`
>
> Submit email contacts for addition to or removal from a Google Ads Customer Match list through an asynchronous offline user data job, marking ad user data and personalization consent as granted. The returned status does not confirm processing completion.
>
> #### Input Parameters
>
> **emails** `array` *required*
>
> Array of emails of contacts to add to or remove from the customer list. Emails must be valid, normalized strings (lowercase, trimmed); malformed addresses reduce match rates.
>
> **operation** `string ("create" | "remove")`
>
> Operation to perform on the customer list (UserList/audience list). Either create or remove.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **resource\_name** `string` *required*
>
> Resource name of the customer list (UserList/audience list), not an account. For example: customers/1234567890/userLists/1234567890. For account-owned resources, use the same customer ID as the tool call's customer\_id; in MCC workflows, this is the child/sub-account ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Mutate Google Ads Resources
>
> **Slug:** `GOOGLEADS_BATCH_MUTATE`
>
> Create, update, remove, or act on supported Google Ads resource types in one request. With partial\_failure=false (the default), all operations are atomic and execute only if every operation is valid. With partial\_failure=true, valid operations execute independently while invalid operations return errors. Use negative temporary resource IDs to connect resources created in the same request. Remove operations are destructive.
>
> #### Input Parameters
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If false (the default), all operations are atomic: they are carried out in one transaction only when every operation is valid. If true, valid operations are carried out independently while invalid operations return errors in partial\_failure\_error.
>
> **mutate\_operations** `array` *required*
>
> Cross-resource operations. Each item must contain exactly one official operation family, such as campaign\_operation or campaign\_budget\_operation, whose value is the provider operation body.
>
> **response\_content\_type** `string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls response content for a cross-resource mutate request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Callout Asset
>
> **Slug:** `GOOGLEADS_CREATE_CALLOUT_ASSET`
>
> Create an immutable account asset containing a validated callout. Associate the returned resource using Mutate Customer Assets with field\_type CALLOUT. Cleanup removes that association; Google does not allow deleting the asset.
>
> #### Input Parameters
>
> **name** `string`
>
> Optional internal name for the immutable callout asset.
>
> **callout** `object` *required*
>
> Validated callout content and optional schedule.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Customer Client
>
> **Slug:** `GOOGLEADS_CREATE_CUSTOMER_CLIENT`
>
> Create a new Google Ads client under an eligible direct parent manager. Requires a manager account, not an advertiser client account. Currency and time zone cannot be changed after creation. Set validate\_only=true to check eligibility and parameters without account creation. Invitation fields require Google allowlisting.
>
> #### Input Parameters
>
> **access\_role** `string ("UNSPECIFIED" | "UNKNOWN" | "ADMIN" | "STANDARD" | "READ_ONLY" | "EMAIL_ONLY")`
>
> Proposed invited user's role, available only to allowlisted managers. Use ADMIN, STANDARD, READ\_ONLY, or EMAIL\_ONLY; UNKNOWN is return-only.
>
> **customer\_id** `string`
>
> Direct parent manager account ID, not a child account ID. Defaults to the connection customer\_id; spaces and hyphens are stripped. An ancestor login-customer-id may be required.
>
> **email\_address** `string`
>
> User to invite to the new account. Available only to allowlisted managers; omit for ordinary account creation.
>
> **validate\_only** `boolean`
>
> If true, validate parameters and manager eligibility without creating an account or inviting a user. Only errors, not results, are returned.
>
> **customer\_client** `object` *required*
>
> New client account's essential settings and optional URL options.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create customer list
>
> **Slug:** `GOOGLEADS_CREATE_CUSTOMER_LIST`
>
> Creates a Google Ads Customer Match user list for contact information, not a customer account. Membership updates can take many hours to propagate; targeting eligibility is not immediate after creation.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the Google Ads customer list (UserList/audience list), not an account.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **description** `string`
>
> Description of the Google Ads customer list (UserList/audience list), not an account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create data manager user list
>
> **Slug:** `GOOGLEADS_CREATE_DATA_MANAGER_USER_LIST`
>
> Create a Data Manager user list, or validate without creating one.
>
> #### Input Parameters
>
> **name** `string`
>
> Resource identifier: accountTypes/\{accountType}/accounts/\{account}/userLists/\{userList}.
>
> **accounts\_id** `string` *required*
>
> Parent account ID, without hyphens for Google Ads.
>
> **description** `string`
>
> Description of the user list.
>
> **display\_name** `string` *required*
>
> Required display name of the user list.
>
> **login\_account** `string`
>
> Optional authorizing account resource: accountTypes/\{type}/accounts/\{id}.
>
> **validate\_only** `boolean`
>
> If true, validate the request without creating a user list.
>
> **linked\_account** `string`
>
> Optional account resource with a product link to login\_account.
>
> **account\_types\_id** `string` *required*
>
> Parent account type, for example GOOGLE\_ADS.
>
> **integration\_code** `string`
>
> External system ID used by user list sellers.
>
> **membership\_status** `string ("MEMBERSHIP_STATUS_UNSPECIFIED" | "OPEN" | "CLOSED")`
>
> Membership status: OPEN accrues members; CLOSED stops new members.
>
> **membership\_duration** `string`
>
> Google duration in seconds ending in s; must be an exact multiple of 86400 seconds (24 hours).
>
> **target\_network\_info** `object`
>
> Eligibility information for target networks.
>
> **account\_access\_status** `string ("ACCESS_STATUS_UNSPECIFIED" | "ENABLED" | "DISABLED")`
>
> Whether this account's shared access remains enabled.
>
> **ingested\_user\_list\_info** `object`
>
> Information for a list populated by ingested user data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Experiment
>
> **Slug:** `GOOGLEADS_CREATE_EXPERIMENT`
>
> Create the experiment definition that begins an experiment setup workflow. Create its control and treatment arms before scheduling it.
>
> #### Input Parameters
>
> **experiment** `object` *required*
>
> Writable fields for the new experiment.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> Validate the request without creating the experiment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Experiment Arms
>
> **Slug:** `GOOGLEADS_CREATE_EXPERIMENT_ARMS`
>
> Create two Google Ads experiment arms in one atomic batch: one control and one treatment arm belonging to the same experiment. The control arm must contain one campaign, and their traffic splits must total 100%.
>
> #### Input Parameters
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> Validate the complete arm set without creating it.
>
> **experiment\_arms** `array` *required*
>
> The control and treatment arms, created atomically in one request.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Return resource names only or mutable experiment-arm fields.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete data manager user list
>
> **Slug:** `GOOGLEADS_DELETE_DATA_MANAGER_USER_LIST`
>
> Delete a Data Manager user list, optionally validating only.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Required user list resource name: accountTypes/\{accountType}/accounts/\{account}/userLists/\{userList}.
>
> **login\_account** `string`
>
> Optional login account resource name; defaults to the account in name.
>
> **validate\_only** `boolean`
>
> If true, validate the request without deleting the user list.
>
> **linked\_account** `string`
>
> Optional account resource name with an established product link to the login account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] End Experiment
>
> **Slug:** `GOOGLEADS_END_EXPERIMENT`
>
> Immediately stop a running experiment without deleting its campaigns, or validate that operation. Google changes the experiment's end date to now.
>
> #### Input Parameters
>
> **experiment** `string` *required*
>
> Experiment resource name: customers/\{customer\_id}/experiments/\{experiment\_id}.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> Validate ending without stopping the experiment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate Keyword Forecast Metrics
>
> **Slug:** `GOOGLEADS_GENERATE_KEYWORD_FORECAST_METRICS`
>
> Forecast clicks, conversions and costs for a hypothetical keyword campaign without creating resources.
>
> #### Input Parameters
>
> **campaign** `object` *required*
>
> Hypothetical campaign to forecast; does not create a campaign.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **currency\_code** `string`
>
> Currency for exchange-rate conversion; defaults to the account currency.
>
> **forecast\_period** `object`
>
> Forecast dates in the customer's timezone; defaults to next Sunday through Saturday.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate Keyword Historical Metrics
>
> **Slug:** `GOOGLEADS_GENERATE_KEYWORD_HISTORICAL_METRICS`
>
> Retrieve historical search volumes, competition, and bid metrics for supplied keywords without creating or changing advertising resources.
>
> #### Input Parameters
>
> **keywords** `array` *required*
>
> Keywords whose historical metrics to retrieve (up to 10,000). Close variants are deduplicated by Google.
>
> **language** `string`
>
> Language resource name, such as languageConstants/1000; omitted means all languages.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **aggregate\_metrics** `object`
>
> Aggregate metrics to include, such as the DEVICE breakdown.
>
> **geo\_target\_constants** `array`
>
> Up to 10 location resource names, such as geoTargetConstants/2840. An empty list targets all geos.
>
> **keyword\_plan\_network** `string ("UNSPECIFIED" | "UNKNOWN" | "GOOGLE_SEARCH" | "GOOGLE_SEARCH_AND_PARTNERS")`
>
> Target network; defaults to Google Search and partners.
>
> **include\_adult\_keywords** `boolean`
>
> Include adult keywords in the response; defaults to false.
>
> **historical\_metrics\_options** `object`
>
> Average CPC and date-range options. Defaults to the past 12 months; up to four years of history is available.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate Keyword Ideas
>
> **Slug:** `GOOGLEADS_GENERATE_KEYWORD_IDEAS`
>
> Generate keyword ideas and planning metrics from exactly one seed form.
>
> #### Input Parameters
>
> **language** `string`
>
> Language constant resource name to target, for example languageConstants/1000.
>
> **url\_seed** `object`
>
> A URL used as the sole idea seed.
>
> **page\_size** `integer`
>
> Number of ideas requested for this page; Google returns at most 10,000.
>
> **site\_seed** `object`
>
> A site domain used as the sole idea seed.
>
> **page\_token** `string`
>
> Token returned as next\_page\_token by the previous page.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **keyword\_seed** `object`
>
> Keywords or phrases used as the sole idea seed.
>
> **aggregate\_metrics** `object`
>
> Aggregate metric breakdowns to include in the response.
>
> **keyword\_annotation** `array`
>
> Keyword annotation types to include in the response.
>
> **geo\_target\_constants** `array`
>
> Up to 10 geo target constant resource names; an empty list targets all geos.
>
> **keyword\_and\_url\_seed** `object`
>
> Keywords and a URL used together as the sole idea seed.
>
> **keyword\_plan\_network** `string ("UNSPECIFIED" | "UNKNOWN" | "GOOGLE_SEARCH" | "GOOGLE_SEARCH_AND_PARTNERS")`
>
> Google Ads network on which to generate keyword ideas.
>
> **include\_adult\_keywords** `boolean`
>
> Whether the response may include adult keywords.
>
> **historical\_metrics\_options** `object`
>
> Options controlling the returned historical metrics.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Campaign By Id
>
> **Slug:** `GOOGLEADS_GET_CAMPAIGN_BY_ID`
>
> Retrieve a Google Ads campaign's name and status by numeric campaign ID for the specified or connected customer account.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> id of the campaign to search on GoogleAds.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get campaign by name
>
> **Slug:** `GOOGLEADS_GET_CAMPAIGN_BY_NAME`
>
> Retrieve the first Google Ads campaign matching an exact name for the specified or connected customer account. Names containing quotes, backslashes, NUL or line breaks are not supported.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the campaign to search on Google Ads. Matched using exact GAQL equality. Unicode and punctuation are supported except quotes, backslashes, NUL, and line breaks, which cannot be safely embedded in the query literal.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Conversion Action Tag Snippets
>
> **Slug:** `GOOGLEADS_GET_CONVERSION_ACTION_TAG_SNIPPETS`
>
> Retrieve provider-generated website or call conversion tag snippets after creating a conversion action. Markup is returned exactly as Google provides it.
>
> #### Input Parameters
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **conversion\_action\_id** `string` *required*
>
> Numeric Google Ads conversion action ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get conversion ingestion status
>
> **Slug:** `GOOGLEADS_GET_CONVERSION_INGESTION_STATUS`
>
> Retrieve one Data Manager ingestion status snapshot. SUCCESS, FAILED, and PARTIAL\_SUCCESS are terminal. PROCESSING and REQUEST\_STATUS\_UNKNOWN are not. The caller owns the documented backoff loop.
>
> #### Input Parameters
>
> **request\_id** `string` *required*
>
> Top-level request\_id returned by an accepted INGEST\_CONVERSION\_EVENTS call. Do not use a Google Ads request-id header or an ID from an error detail; those transport diagnostics cannot be polled here.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get customer lists
>
> **Slug:** `GOOGLEADS_GET_CUSTOMER_LISTS`
>
> List a page of Google Ads customer lists (audience and remarketing user segments), not Google Ads accounts. Use the returned next-page token to retrieve further lists, and review similarly named results before selecting one.
>
> #### Input Parameters
>
> **page\_token** `string`
>
> Pagination token from a previous response's next\_page\_token.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get data manager user list
>
> **Slug:** `GOOGLEADS_GET_DATA_MANAGER_USER_LIST`
>
> Get one Data Manager user list without modifying it.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Resource name: accountTypes/\{accountType}/accounts/\{account}/userLists/\{userList}.
>
> **login\_account** `string`
>
> Optional login account resource name; defaults to the account in name.
>
> **linked\_account** `string`
>
> Optional account resource name with an established product link to the login account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Experiment
>
> **Slug:** `GOOGLEADS_GET_EXPERIMENT`
>
> Get one Google Ads experiment by resource name or numeric ID.
>
> #### Input Parameters
>
> **experiment** `string` *required*
>
> Numeric experiment ID or full experiment resource name.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Experiment Arm
>
> **Slug:** `GOOGLEADS_GET_EXPERIMENT_ARM`
>
> Get one Google Ads experiment arm, including draft campaigns.
>
> #### Input Parameters
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **experiment\_arm** `string` *required*
>
> Full experiment arm resource name in the form customers/\{customer\_id}/experimentArms/\{experiment\_id}\~\{arm\_id}.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Required Google Ads Report
>
> **Slug:** `GOOGLEADS_GET_RMF_REPORT`
>
> Run a prominent, bounded Google Ads report template for Customer, Campaign, Ad, Keyword, Search Term, Dynamic Search Ads Search Term, or Bidding Strategy. Official required columns are always selected; dates default to LAST\_30\_DAYS.
>
> #### Input Parameters
>
> **report** `string ("CUSTOMER" | "CAMPAIGN" | "AD_GROUP_AD" | "KEYWORD" | "SEARCH_TERM" | "DYNAMIC_SEARCH_AD_SEARCH_TERM" | "BIDDING_STRATEGY")` *required*
>
> Required Google Ads report template. Each template always includes its official RMF columns plus useful identity columns.
>
> **end\_date** `string`
>
> Optional inclusive report end date in YYYY-MM-DD format.
>
> **max\_rows** `integer`
>
> Maximum rows returned. The action queries one extra row and reports truncated=true instead of silently dropping results.
>
> **start\_date** `string`
>
> Optional inclusive report start date in YYYY-MM-DD format.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **optional\_metrics** `array`
>
> Additional v26 metrics compatible with the selected report, such as metrics.ctr. Required columns cannot be removed. Google validates resource compatibility.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Ingest ad events
>
> **Slug:** `GOOGLEADS_INGEST_AD_EVENTS`
>
> Upload ad events for an allowlisted Data Partner to Google Analytics, not Ads. Requires an eligible Data Partner account linked to the target advertiser. Use validate\_only=true for the provider's deprecated no-execution check. The response is empty; this operation does not return a request ID.
>
> #### Input Parameters
>
> **ad\_events** `array` *required*
>
> At least one ad event to upload to Google Analytics; no Google Ads destinations are supported by this endpoint.
>
> **login\_account** `string` *required*
>
> Required Data Partner resource name where the credential's Google Account is a user: accountTypes/DATA\_PARTNER/accounts/\{loginAccountId}. Not an Ads customer ID.
>
> **validate\_only** `boolean`
>
> Deprecated by Google but documented: true validates without executing; false ingests advertising events irreversibly.
>
> **encryption\_info** `object`
>
> Encryption key information; required whenever an ad event contains user\_data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Ingest audience members
>
> **Slug:** `GOOGLEADS_INGEST_AUDIENCE_MEMBERS`
>
> Validate or asynchronously ingest Data Manager audience members. Use validate\_only=true for a no-upload check. Customer Match terms must already be accepted for contact/mobile data; do not assert acceptance without authority. Consent may be supplied per request or member. A request ID confirms acceptance, not completion; poll request status for processing errors and partial failures.
>
> #### Input Parameters
>
> **consent** `object`
>
> Request-level consent; individual member consent overrides it.
>
> **encoding** `string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")`
>
> Required for UserData uploads: encoding of the hashed string, or outer encrypted string if encrypted. Ignored for other uploads.
>
> **destinations** `array` *required*
>
> Destinations receiving the audience members.
>
> **validate\_only** `boolean`
>
> True validates without executing; only errors, not results, are returned. False starts asynchronous ingestion.
>
> **encryption\_info** `object`
>
> Optional encryption for UserData. Omit for hashed, unencrypted identifiers; ignored for other uploads.
>
> **audience\_members** `array` *required*
>
> One to 10,000 audience members to ingest.
>
> **terms\_of\_service** `object`
>
> Explicit caller decision on applicable terms; does not automatically accept terms.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Ingest conversion events
>
> **Slug:** `GOOGLEADS_INGEST_CONVERSION_EVENTS`
>
> Validate or submit a bounded Google Ads conversion-event batch. Set validate\_only=true for a no-ingestion check. False starts irreversible asynchronous processing and returns a request ID for later status checks.
>
> #### Input Parameters
>
> **events** `array` *required*
>
> One to 2,000 conversion events to validate or ingest.
>
> **consent** `object`
>
> Request-level consent applied unless an event supplies its own consent.
>
> **encoding** `string ("HEX" | "BASE64")`
>
> Encoding of normalized SHA-256 user identifiers; required with user data.
>
> **destinations** `array` *required*
>
> One to ten Google Ads destinations for this batch.
>
> **validate\_only** `boolean`
>
> Validate without ingesting when true. False starts irreversible asynchronous processing for an accepted batch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Ingest users
>
> **Slug:** `GOOGLEADS_INGEST_USERS`
>
> Ingest account-level identity linkage, not audience-list membership. Requires provider allowlisting. Each user links hashed first-party identifiers with mobile device IDs. Set validate\_only=true for no ingestion. A request ID confirms asynchronous acceptance, not completion; poll request status for errors.
>
> #### Input Parameters
>
> **users** `array` *required*
>
> Users to ingest; each must include both user\_data and mobile\_data.
>
> **encoding** `string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")` *required*
>
> Required user-identifier encoding; for encrypted identifiers, the outer encoding.
>
> **destinations** `array` *required*
>
> Accounts receiving the identity linkage data. Requires provider allowlisting.
>
> **validate\_only** `boolean`
>
> True validates without execution. False starts asynchronous ingestion.
>
> **encryption\_info** `object`
>
> Optional encryption key information; omit for hashed, unencrypted identifiers.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Accessible Customers
>
> **Slug:** `GOOGLEADS_LIST_ACCESSIBLE_CUSTOMERS`
>
> List Google Ads customer resource names directly accessible to the authenticated OAuth user. Google determines the complete result from the OAuth credentials and ignores customer\_id and login-customer-id; this action does not filter the response. For MCC child account names, status, and direct hierarchy, use List Sub Accounts.
>
> #### Input Parameters
>
> **customer\_id** `string`
>
> Deprecated compatibility parameter. Google ignores this value and returns customer resource names directly accessible with the current OAuth credentials; it does not filter by this customer ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List data manager conversion actions
>
> **Slug:** `GOOGLEADS_LIST_DATA_MANAGER_CONVERSION_ACTIONS`
>
> List conversion actions usable as Google Ads Data Manager destinations. Returns numeric destination IDs, true owning accounts, action types, and availability; defaults to enabled offline and enhanced-lead actions.
>
> #### Input Parameters
>
> **statuses** `array`
>
> Statuses to include. Keep ENABLED for an ingestible destination; HIDDEN and REMOVED are primarily useful for diagnosis.
>
> **use\_case** `string`
>
> Select enabled UPLOAD\_CLICKS actions for offline conversion ingestion.
>
> **customer\_id** `string`
>
> Google Ads customer to query; hyphens and spaces are accepted and removed. Query the conversion account that owns the actions, not merely a child account that uses cross-account conversion tracking. Defaults to the connection customer\_id.
>
> **name\_contains** `string`
>
> Optional case-insensitive literal substring of the conversion action name.
>
> **primary\_for\_goal** `boolean`
>
> Require primary\_for\_goal to be true or false; omit to return both.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List data manager user lists
>
> **Slug:** `GOOGLEADS_LIST_DATA_MANAGER_USER_LISTS`
>
> List one page of Data Manager user lists and their lifecycle configuration.
>
> #### Input Parameters
>
> **filter** `string`
>
> Filter using AND, =, !=, >, >=, \<, \<=, : (has), or IN(field, values...). Supported fields: id, display\_name, description, membership\_status, integration\_code, access\_reason, ingested\_user\_list\_info.upload\_key\_types. Use either all snake\_case or all camelCase field names, with fields on the left.
>
> **parent** `string` *required*
>
> Account owning the collection, in accountTypes/\{accountType}/accounts/\{account} form.
>
> **page\_size** `integer`
>
> Maximum lists to return. Defaults to at most 50; Google coerces values above 1000 to 1000.
>
> **page\_token** `string`
>
> Token from next\_page\_token; keep all other parameters unchanged when continuing.
>
> **login\_account** `string`
>
> Optional accountTypes/\{type}/accounts/\{id} where the credential user has access; defaults to parent.
>
> **linked\_account** `string`
>
> Optional accountTypes/\{type}/accounts/\{id} with an established product link to login-account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Experiment Arms
>
> **Slug:** `GOOGLEADS_LIST_EXPERIMENT_ARMS`
>
> List Google Ads experiment arms, including draft campaigns.
>
> #### Input Parameters
>
> **control** `boolean`
>
> Filter control/test arms.
>
> **experiment** `string`
>
> Optional experiment resource name to filter by.
>
> **page\_token** `string`
>
> Token returned as next\_page\_token by the previous page.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Experiments
>
> **Slug:** `GOOGLEADS_LIST_EXPERIMENTS`
>
> List Google Ads experiments, optionally filtered by status and type.
>
> #### Input Parameters
>
> **status** `string ("ENABLED" | "REMOVED" | "HALTED" | "PROMOTED" | "SETUP" | "INITIATED" | "GRADUATED")`
>
> Filter by status.
>
> **page\_token** `string`
>
> Token returned as next\_page\_token by the previous page.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **experiment\_type** `string ("DISPLAY_AND_VIDEO_360" | "AD_VARIATION" | "YOUTUBE_CUSTOM" | "DISPLAY_CUSTOM" | "SEARCH_CUSTOM" | "DISPLAY_AUTOMATED_BIDDING_STRATEGY" | "SEARCH_AUTOMATED_BIDDING_STRATEGY" | "SHOPPING_AUTOMATED_BIDDING_STRATEGY" | "SMART_MATCHING" | "HOTEL_CUSTOM")`
>
> Filter by experiment type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sub Accounts
>
> **Slug:** `GOOGLEADS_LIST_SUB_ACCOUNTS`
>
> List direct child/sub-accounts under a Google Ads manager (MCC) account. Use this before account-scoped read or mutate calls when a user needs to choose which child account to target. The returned customer\_id values can be passed to other Google Ads tools as their customer\_id.
>
> #### Input Parameters
>
> **page\_token** `string`
>
> Pagination token from a previous response's next\_page\_token.
>
> **customer\_id** `string`
>
> Manager/MCC Google Ads customer ID whose direct sub-accounts should be listed; hyphens and spaces are stripped. Defaults to the connection customer\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Ad Group Ads
>
> **Slug:** `GOOGLEADS_MUTATE_AD_GROUP_ADS`
>
> Create, update, or remove ads in Google Ads ad groups, including responsive search ads. Use this after creating campaigns, budgets, ad groups, and keywords so the ad group has creative that can serve.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> AdGroupAd operations. For responsive search ads, create payloads usually include ad\_group, status, and ad.responsive\_search\_ad with headlines/descriptions, plus ad.final\_urls.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Ad Group Assets
>
> **Slug:** `GOOGLEADS_MUTATE_AD_GROUP_ASSETS`
>
> Create, update, or remove links between assets and ad groups. Use this after creating assets to attach sitelinks, callouts, snippets, images, and other asset types at ad group level.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> AdGroupAsset operations for linking assets to ad groups. Create payloads commonly include ad\_group, asset, field\_type, and status.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Ad Group Bid Modifiers
>
> **Slug:** `GOOGLEADS_MUTATE_AD_GROUP_BID_MODIFIERS`
>
> Create, update, or remove ad group bid modifiers, such as device bid adjustments or hotel-specific bid modifier criteria.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> AdGroupBidModifier operations. Common create fields include ad\_group, bid\_modifier, and exactly one criterion such as device or hotel-specific bid modifier criteria.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Ad Group Criteria
>
> **Slug:** `GOOGLEADS_MUTATE_AD_GROUP_CRITERIA`
>
> Create, update, or remove Google Ads ad group criteria in a batch, including keywords, audiences, demographics, mobile apps, YouTube placements, topics, webpages, and Shopping listing groups. Manage bids or remove criteria; removal is irreversible, and validate-only requests test changes without committing them.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> List of ad group criterion operations to apply atomically (unless partial\_failure=true). Each operation MUST contain exactly one of: create, update, or remove.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, the request is validated but no changes are applied. Useful for dry runs. Mutually exclusive with partial\_failure (cannot both be true).
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when others in the batch fail. Errors are returned in partial\_failure\_error. If false, the entire batch is atomic — any failure rolls back all changes.
>
> **response\_content\_type** `string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of the mutated resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Ad Groups
>
> **Slug:** `GOOGLEADS_MUTATE_AD_GROUPS`
>
> Create, update, or remove ad groups within Google Ads campaigns. Supports batch operations with multiple ad group changes in a single request. Use when you need to manage ad groups programmatically, such as creating new ad groups for campaigns, updating ad group settings or status, or removing ad groups that are no longer needed. This action is irreversible for remove operations — deleted ad groups cannot be recovered once removed.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> List of ad group operations (create, update, or remove). At least one operation is required.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without executing. Useful for testing before making actual changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even if other operations fail. Defaults to false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Ads
>
> **Slug:** `GOOGLEADS_MUTATE_ADS`
>
> Update existing Google Ads ad creative fields. Does not create or remove ads or modify ad-group association/status. Updating TextAd, ExpandedDynamicSearchAd, GmailAd, and ImageAd is not supported. Use validate\_only for a dry run and inspect partial\_failure\_error when partial\_failure is enabled.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> Update operations on individual ads.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> Validate without applying changes; only errors, not results, are returned.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed and failed operations are reported in partial\_failure\_error, even with HTTP 200. Otherwise atomic.
>
> **response\_content\_type** `string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> RESOURCE\_NAME\_ONLY or UNSPECIFIED returns resource names; MUTABLE\_RESOURCE also returns mutable ad fields when possible.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Asset Group Assets
>
> **Slug:** `GOOGLEADS_MUTATE_ASSET_GROUP_ASSETS`
>
> Create, update, or remove links between assets and Performance Max asset groups. Use this after creating compatible assets and an asset group.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> AssetGroupAsset operations. Create payloads include asset\_group, asset, field\_type, and status. Updates require resource\_name and mutable fields such as status; update\_mask is generated when omitted. Remove uses customers/\{customer\_id}/assetGroupAssets/\{asset\_group\_id}~~\{asset\_id}~~\{field\_type}.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Asset Groups
>
> **Slug:** `GOOGLEADS_MUTATE_ASSET_GROUPS`
>
> Create, update, or remove Google Ads asset groups for Performance Max campaigns. Use validate\_only to check operations without making changes. Link assets separately with Mutate Asset Group Assets. Creating Performance Max asset groups may require a GoogleAdsService mutate with asset links in the same request to satisfy minimum asset requirements.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> AssetGroup create, update, or remove operations. Create payloads use campaign (customers/\{customer\_id}/campaigns/\{campaign\_id}), name (1-128 characters, unique within the campaign), and fields such as status, final\_urls, final\_mobile\_urls, path1, path2, tracking\_url\_template, final\_url\_suffix, or url\_custom\_parameters (key/value mappings). Updates require resource\_name and mutable fields; update\_mask is generated when omitted. Remove uses customers/\{customer\_id}/assetGroups/\{asset\_group\_id}. Snake\_case and lowerCamelCase resource fields are accepted. Set exactly one of create, update, or remove per operation.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes. Only errors are returned, not mutation results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Assets
>
> **Slug:** `GOOGLEADS_MUTATE_ASSETS`
>
> Create or update supported Google Ads assets such as sitelinks, structured snippets, text assets, lead forms, promotions, calls, price assets, and media assets. Use Create Callout Asset for validated immutable callouts. Google Ads does not allow removing assets; cleanup removes their resource associations.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> Asset operations. Supported asset payloads include text\_asset, callout\_asset, structured\_snippet\_asset, sitelink\_asset, lead\_form\_asset, promotion\_asset, call\_asset, price\_asset, youtube\_video\_asset, media\_bundle\_asset, and other Google Ads Asset fields.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Asset Sets
>
> **Slug:** `GOOGLEADS_MUTATE_ASSET_SETS`
>
> Create, update, or remove Google Ads asset sets, which group assets for feeds, locations, and other campaign uses. Link assets to a set separately with an AssetSetAsset mutation, and attach sets to campaigns with Mutate Campaign Asset Sets.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> AssetSet operations. Create payloads require name and type. Updates require resource\_name and mutable fields such as name; update\_mask is generated when omitted. Remove uses customers/\{customer\_id}/assetSets/\{asset\_set\_id}.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> UNSPECIFIED uses the API default. RESOURCE\_NAME\_ONLY returns only resource names. MUTABLE\_RESOURCE returns mutable resource fields after mutation when supported.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Audiences
>
> **Slug:** `GOOGLEADS_MUTATE_AUDIENCES`
>
> Create or update Google Ads audiences combining segment attributes. Does not support removal. Use validate\_only to check operations without changing audiences. Inspect partial\_failure\_error when partial\_failure is true.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> Audience create or update operations; remove is not supported. Create accepts name, description, dimensions, exclusion\_dimension, scope, and asset\_group. CUSTOMER scope requires a unique name (1-255 characters); ASSET\_GROUP scope requires asset\_group and forbids name. Updates need resource\_name (customers/\{customer\_id}/audiences/\{audience\_id}) and mutable fields. update\_mask is generated if omitted. Nested payload keys accept snake\_case or lowerCamelCase.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> UNSPECIFIED or RESOURCE\_NAME\_ONLY returns resource names; MUTABLE\_RESOURCE also returns mutable audience fields when available.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Bidding Strategies
>
> **Slug:** `GOOGLEADS_MUTATE_BIDDING_STRATEGIES`
>
> Create, update, or remove portfolio bidding strategies such as Target CPA, Target ROAS, Target Spend, Maximize Conversions, Maximize Conversion Value, and Target Impression Share.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> BiddingStrategy operations. Create payloads include name and one bidding scheme such as target\_cpa, target\_roas, target\_spend, maximize\_conversions, maximize\_conversion\_value, or target\_impression\_share.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Campaign Assets
>
> **Slug:** `GOOGLEADS_MUTATE_CAMPAIGN_ASSETS`
>
> Create, update, or remove links between assets and campaigns. Use this after creating assets to attach sitelinks, callouts, snippets, and other asset types at campaign level.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> CampaignAsset operations for linking assets to campaigns. Create payloads commonly include campaign, asset, field\_type, and status.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Campaign Budgets
>
> **Slug:** `GOOGLEADS_MUTATE_CAMPAIGN_BUDGETS`
>
> Create, update, or remove Google Ads campaign budgets. Use this before creating campaigns because campaign creation requires an existing campaign\_budget resource name.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> CampaignBudget operations. Common create/update fields include name, amount\_micros, total\_amount\_micros, delivery\_method, explicitly\_shared, period, type, and resource\_name for updates.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Campaign Criteria
>
> **Slug:** `GOOGLEADS_MUTATE_CAMPAIGN_CRITERIA`
>
> Create, update, or remove campaign-level targeting criteria such as locations, languages, campaign-level negative keywords, devices, schedules, audiences, and IP exclusions.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> CampaignCriterion operations for campaign-level targeting or exclusions. Common create fields include campaign, negative, status, bid\_modifier, and exactly one criterion field such as location, language, keyword, device, ad\_schedule, or ip\_block.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Campaign Labels
>
> **Slug:** `GOOGLEADS_MUTATE_CAMPAIGN_LABELS`
>
> Create or remove relationships between campaigns and labels. Use this after creating labels to organize campaigns for filtering and reporting.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> CampaignLabel operations. Create payloads include campaign and label resource names. Remove uses customers/\{customer\_id}/campaignLabels/\{campaign\_id}\~\{label\_id}.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Campaigns
>
> **Slug:** `GOOGLEADS_MUTATE_CAMPAIGNS`
>
> Create, update, or remove Google Ads campaigns in a batch; removal is irreversible and validate-only can check changes before applying them. Creates default to a declaration that the campaign does not contain EU political advertising and to Manual CPC when no bidding strategy is supplied.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> List of campaign operations to perform. Each operation can be create, update, or remove. At least one operation is required.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without executing. Useful for testing before making actual changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even if others fail. Partial failures will be reported in the response.
>
> **response\_content\_type** `string`
>
> Whether to return full resource or just resource name. Options: 'RESOURCE\_NAME\_ONLY' or 'MUTABLE\_RESOURCE'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Campaigns V2
>
> **Slug:** `GOOGLEADS_MUTATE_CAMPAIGNS_V2`
>
> Create, update, or remove Search and Display Google Ads campaigns in a batch; new campaigns default to paused when status is omitted. Removal is irreversible, and validate-only can check changes before applying them.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> List of campaign operations to perform. Each operation can be create, update, or remove. At least one operation is required.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without executing. Useful for testing before making actual changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even if others fail. Partial failures will be reported in the response.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Conversion Actions
>
> **Slug:** `GOOGLEADS_MUTATE_CONVERSION_ACTIONS`
>
> Create, update, or remove Google Ads conversion actions for conversion tracking configuration. This manages Google Ads conversion action resources; installing website/app tags remains outside this action.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> ConversionAction operations. Common fields include name, status, type, category, primary\_for\_goal, lookback windows, value\_settings, counting\_type, and attribution\_model\_settings.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Custom Audiences
>
> **Slug:** `GOOGLEADS_MUTATE_CUSTOM_AUDIENCES`
>
> Create, update, or remove Google Ads custom audiences used to reach users by interests, searches, visited URLs, place categories, or installed apps.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> CustomAudience operations. Create payloads require name and type. Updates require resource\_name and mutable fields; update\_mask is generated when omitted. Remove uses customers/\{customer\_id}/customAudiences/\{custom\_audience\_id}.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Customer
>
> **Slug:** `GOOGLEADS_MUTATE_CUSTOMER`
>
> Update one Google Ads customer's mutable account settings using CustomerService. This is not the GoogleAdsService batch mutate endpoint. Use validate\_only=true to check an update without changing account settings.
>
> #### Input Parameters
>
> **operation** `object` *required*
>
> The single customer update operation to perform.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates without applying changes; no result is returned.
>
> **response\_content\_type** `string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> RESOURCE\_NAME\_ONLY or UNSPECIFIED returns the resource name; MUTABLE\_RESOURCE also returns mutable customer fields when possible.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Customer Assets
>
> **Slug:** `GOOGLEADS_MUTATE_CUSTOMER_ASSETS`
>
> Create or remove customer-level asset associations. Removal irreversibly removes the current association; recreate it to restore the link. Use this after creating assets to attach callouts, sitelinks, snippets, and other asset types across a Google Ads customer account.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> CustomerAsset operations for associating assets with a customer or removing existing customer-level associations.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Keyword Plan Ad Group Keywords
>
> **Slug:** `GOOGLEADS_MUTATE_KEYWORD_PLAN_AD_GROUP_KEYWORDS`
>
> Create, update, or remove Google Ads Keyword Planner ad group keywords. These are planning resources, not serving keywords. Creates need an existing Keyword Plan ad group. Use validate\_only to validate without applying changes; validation returns no results. Inspect partial\_failure\_error when partial\_failure is enabled, even on HTTP 200.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> KeywordPlanAdGroupKeyword operations, each with exactly one of create, update, or remove. Create accepts keyword\_plan\_ad\_group (the parent resource name), text, match\_type (EXACT, PHRASE, BROAD), negative, and optional cpc\_bid\_micros (an int64 decimal string overriding the ad group bid; not applicable to negative keywords). Do not supply the output-only id. Update includes resource\_name and changed fields, with update\_mask or a mask generated from non-null fields. negative is immutable. Remove uses customers/\{customer\_id}/keywordPlanAdGroupKeywords/\{kp\_ad\_group\_keyword\_id}. Resource dictionaries accept snake\_case or lowerCamelCase keys.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Keyword Plan Ad Groups
>
> **Slug:** `GOOGLEADS_MUTATE_KEYWORD_PLAN_AD_GROUPS`
>
> Create, update, or remove Google Ads Keyword Planner ad groups. These are planning resources, not serving ad groups. A create needs an existing keyword plan campaign. Use validate\_only to check operations without applying changes; validation returns no results. Inspect partial\_failure\_error when partial\_failure is enabled, even on HTTP 200.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> KeywordPlanAdGroup operations, each with exactly one of create, update, or remove. Create requires a non-empty name and the parent keyword\_plan\_campaign resource name. Optional cpc\_bid\_micros is an int64 decimal string; when omitted the campaign bid is inherited. Updates include resource\_name and changed fields, with an optional update\_mask (otherwise generated). Remove uses customers/\{customer\_id}/keywordPlanAdGroups/\{kp\_ad\_group\_id}. Resource dictionaries accept snake\_case or lowerCamelCase keys.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Keyword Plan Campaign Keywords
>
> **Slug:** `GOOGLEADS_MUTATE_KEYWORD_PLAN_CAMPAIGN_KEYWORDS`
>
> Create, update, or remove negative keywords in Keyword Plan campaigns. These planning resources do not change serving campaign keywords. Set validate\_only to validate without changes. With partial\_failure, inspect partial\_failure\_error even on HTTP success; valid operations may be applied.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> KeywordPlanCampaignKeyword create, update, or remove operations. For create, provide keyword\_plan\_campaign (customers/\{customer\_id}/keywordPlanCampaigns/\{campaign\_id}), text, match\_type (EXACT, PHRASE, or BROAD), and negative=true. Only negative campaign keywords are supported. Updates require resource\_name and fields to change, with optional update\_mask; negative is immutable. Remove takes customers/\{customer\_id}/keywordPlanCampaignKeywords/\{keyword\_id}. Use snake\_case or lowerCamelCase resource keys. Do not supply the output-only id. Resource names must belong to the target customer.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Keyword Plan Campaigns
>
> **Slug:** `GOOGLEADS_MUTATE_KEYWORD_PLAN_CAMPAIGNS`
>
> Create, update, or remove campaigns in an existing Keyword Plan. These planning resources do not create serving ad campaigns. Set validate\_only to validate without changes. With partial\_failure, inspect partial\_failure\_error even on HTTP success; successful operations may still have been applied.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> KeywordPlanCampaign create, update, or remove operations. For create, provide keyword\_plan (customers/\{customer\_id}/keywordPlans/\{plan\_id}), name, cpc\_bid\_micros (int64 string in account currency), and keyword\_plan\_network (GOOGLE\_SEARCH or GOOGLE\_SEARCH\_AND\_PARTNERS). Optional language\_constants accepts at most one language resource name; geo\_targets accepts up to 20 objects with geo\_target\_constant. A plan allows at most one campaign. Updates require resource\_name; remove is customers/\{customer\_id}/keywordPlanCampaigns/\{campaign\_id}. Use snake\_case or lowerCamelCase resource keys.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Keyword Plans
>
> **Slug:** `GOOGLEADS_MUTATE_KEYWORD_PLANS`
>
> Create, update, or remove saved Google Ads Keyword Planner plans. These plans are planning resources, not live advertising campaigns. Use validate\_only to validate without saving changes. With partial\_failure, inspect partial\_failure\_error even when the HTTP request succeeds.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> KeywordPlan operations. Create requires a non-empty name and no resource\_name. Optional forecast\_period accepts either date\_interval (NEXT\_WEEK, NEXT\_MONTH, NEXT\_QUARTER) or date\_range with start\_date and end\_date (YYYY-MM-DD, future dates, at most one year). Update requires resource\_name customers/\{customer\_id}/keywordPlans/\{plan\_id} and the fields to change; update\_mask is generated if omitted. Remove takes that resource name. The id field is output-only. Resource keys accept snake\_case or lowerCamelCase.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Labels
>
> **Slug:** `GOOGLEADS_MUTATE_LABELS`
>
> Create, update, or remove Google Ads labels. Pair this with campaign label mutations to organize campaigns and support filtering.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> Label operations. Common fields include name and text\_label with background\_color and description.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Portfolio Bidding Strategies
>
> **Slug:** `GOOGLEADS_MUTATE_PORTFOLIO_BIDDING_STRATEGIES`
>
> Create, edit, or remove typed Target CPA and Target ROAS portfolio strategies. Attach with Mutate Campaigns, read with Get Required Google Ads Report, and transition all campaigns before removal. Budget alignment is not exposed because Google requires the bidding strategy and campaign budget to be changed atomically with GoogleAdsService.Mutate, while this action uses the resource-specific mutate endpoint. currency\_code can be set on create only for manager-account strategies.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> Typed Target CPA or Target ROAS portfolio strategy operations.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Controls how much of each mutated Google Ads resource is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Shared Criteria
>
> **Slug:** `GOOGLEADS_MUTATE_SHARED_CRITERIA`
>
> Create or remove criteria in a Google Ads shared set, such as negative keywords or excluded placements shared across campaigns.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> SharedCriterion operations. Create payloads require shared\_set and one criterion field, such as keyword or placement. Remove uses customers/\{customer\_id}/sharedCriteria/\{shared\_set\_id}\~\{criterion\_id}.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> UNSPECIFIED uses the API default. RESOURCE\_NAME\_ONLY returns only resource names. MUTABLE\_RESOURCE also returns mutable shared criterion fields when possible.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate Shared Sets
>
> **Slug:** `GOOGLEADS_MUTATE_SHARED_SETS`
>
> Create, update, or remove Google Ads shared sets used to group shared criteria, such as negative keyword lists, for reuse across campaigns.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> SharedSet operations. Create payloads require name and type. Updates require resource\_name and mutable fields such as name; update\_mask is generated when omitted. Remove uses customers/\{customer\_id}/sharedSets/\{shared\_set\_id}.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> **response\_content\_type** `string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> UNSPECIFIED uses the API default. RESOURCE\_NAME\_ONLY returns only resource names. MUTABLE\_RESOURCE returns mutable resource fields after mutation when supported.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mutate User Lists
>
> **Slug:** `GOOGLEADS_MUTATE_USER_LISTS`
>
> Create, update, or remove general Google Ads user-list resources used for audience targeting and remarketing.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> UserList operations. Create and update accept Google Ads UserList fields; updates include resource\_name, and remove uses a user-list resource name.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validates the request without applying changes.
>
> **partial\_failure** `boolean`
>
> If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial\_failure\_error.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove all audience members
>
> **Slug:** `GOOGLEADS_REMOVE_ALL_AUDIENCE_MEMBERS`
>
> Validate or asynchronously remove all members of Data Manager audiences.
>
> #### Input Parameters
>
> **destinations** `array` *required*
>
> Destinations from which to remove all audience members.
>
> **validate\_only** `boolean`
>
> When true, validate without removing members; only errors are returned.
>
> **remove\_as\_of\_time** `string`
>
> RFC 3339 timestamp, not in the future. Only members last added before this time are removed. Omit to use the current time.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove audience members
>
> **Slug:** `GOOGLEADS_REMOVE_AUDIENCE_MEMBERS`
>
> Remove specific users from Data Manager audience destinations. Set validate\_only=true to validate without removing users. Execution is asynchronous: a request ID indicates acceptance, not completion. Query its status for errors and partial failures.
>
> #### Input Parameters
>
> **encoding** `string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")`
>
> Required for user data; outer encoding if encrypted. Ignored for other data types.
>
> **destinations** `array` *required*
>
> Destinations from which to remove users.
>
> **validate\_only** `boolean`
>
> True validates without removal; only errors, not results, are returned. Omitted/false executes removal.
>
> **encryption\_info** `object`
>
> User-data encryption details; omit for hashed but unencrypted identifiers.
>
> **audience\_members** `array` *required*
>
> Audience members to remove; does not remove the list itself.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove users
>
> **Slug:** `GOOGLEADS_REMOVE_USERS`
>
> Remove users identified by hashed user data from Data Manager destinations. Available only to allowlisted accounts; takes user\_data, not audience\_members or mobile IDs. Set validate\_only=true to validate without removal. A request ID indicates asynchronous acceptance, not completion; query request status for processing errors and partial failures.
>
> #### Input Parameters
>
> **encoding** `string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")` *required*
>
> Required encoding of user identifiers; for encrypted identifiers, the outer encoding.
>
> **user\_data** `array` *required*
>
> UserData keys identifying users to remove; not AudienceMember objects or mobile IDs.
>
> **destinations** `array` *required*
>
> Destinations from which the identified users are removed.
>
> **validate\_only** `boolean`
>
> True validates without execution; omitted or false submits asynchronous removal.
>
> **encryption\_info** `object`
>
> Encryption key information; omit for unencrypted hashed identifiers.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Schedule Experiment
>
> **Slug:** `GOOGLEADS_SCHEDULE_EXPERIMENT`
>
> Schedule a Google Ads experiment and return its long-running operation. This materializes the treatment campaign and can begin serving and spending on its start date; the experiment cannot return to SETUP after scheduling. When validate\_only is true, Google validates the request and returns no operation.
>
> #### Input Parameters
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **resource\_name** `string` *required*
>
> Experiment resource name: customers/\{customer\_id}/experiments/\{experiment\_id}.
>
> **validate\_only** `boolean`
>
> Validate scheduling without materializing the experiment campaign.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search GAQL
>
> **Slug:** `GOOGLEADS_SEARCH_GAQL`
>
> Run one page of a GAQL search and return its continuation token.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> The Google Ads Query Language (GAQL) query to run.
>
> **page\_token** `string`
>
> Token from next\_page\_token in the preceding search response.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validate the query without executing it.
>
> **search\_settings** `object`
>
> Optional controls for result counts, summary rows, and rows.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Google Ads Fields
>
> **Slug:** `GOOGLEADS_SEARCH_GOOGLE_ADS_FIELDS`
>
> Search the Google Ads v26 field metadata catalog with GAQL.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> GAQL metadata query selecting Google Ads field attributes. For example, SELECT name, category, data\_type, selectable WHERE name LIKE 'campaign.%'.
>
> **page\_size** `integer`
>
> Maximum field definitions to request in this page. Google may return fewer results than requested.
>
> **page\_token** `string`
>
> Token returned as next\_page\_token by the previous page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Stream GAQL
>
> **Slug:** `GOOGLEADS_SEARCH_STREAM_GAQL`
>
> Execute a Google Ads Query Language (GAQL) query and aggregate every streamed response batch in order. For very large reports, select only needed fields and use WHERE and LIMIT because action responses are returned inline and are not automatically offloaded.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> The Google Ads Query Language (GAQL) query string. Must follow SELECT ... FROM ... WHERE ... format. Example: SELECT campaign.name, campaign.id, metrics.impressions FROM campaign WHERE campaign.status = 'ENABLED'
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **summary\_row\_setting** `string ("UNSPECIFIED" | "NO_SUMMARY_ROW" | "SUMMARY_ROW_ONLY" | "SUMMARY_ROW_WITH_RESULTS")`
>
> Whether to include a summary row with aggregated metrics. Valid values are 'UNSPECIFIED', 'NO\_SUMMARY\_ROW', 'SUMMARY\_ROW\_ONLY', and 'SUMMARY\_ROW\_WITH\_RESULTS'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update data manager user list
>
> **Slug:** `GOOGLEADS_UPDATE_DATA_MANAGER_USER_LIST`
>
> Update mutable Data Manager user-list metadata, optionally validating only.
>
> #### Input Parameters
>
> **account\_id** `string` *required*
>
> Account ID owning the user list.
>
> **description** `string`
>
> Description; an empty string clears the description.
>
> **update\_mask** `string`
>
> Optional comma-separated FieldMask using provider lowerCamelCase paths, for example displayName,description or targetNetworkInfo.eligibleForSearch. Passed unchanged; omit to use provider defaults. Fields in the mask but absent from the body are reset to their default values.
>
> **account\_type** `string` *required*
>
> Account type, for example GOOGLE\_ADS.
>
> **display\_name** `string`
>
> New display name. Omit when updating other fields.
>
> **user\_list\_id** `string` *required*
>
> ID of the user list to update.
>
> **login\_account** `string`
>
> Optional authorizing account resource: accountTypes/\{type}/accounts/\{id}.
>
> **validate\_only** `boolean`
>
> If true, validate the request without updating the list.
>
> **linked\_account** `string`
>
> Optional linked account resource: accountTypes/\{type}/accounts/\{id}.
>
> **integration\_code** `string`
>
> External-system identifier used by user-list sellers.
>
> **membership\_status** `string ("MEMBERSHIP_STATUS_UNSPECIFIED" | "OPEN" | "CLOSED")`
>
> Whether this list accepts new members.
>
> **membership\_duration** `string`
>
> Protobuf duration in seconds, ending in s; exact multiples of 86400 seconds.
>
> **target\_network\_info** `object`
>
> Mutable target-network eligibility information.
>
> **account\_access\_status** `string ("ACCESS_STATUS_UNSPECIFIED" | "ENABLED" | "DISABLED")`
>
> Whether the account's access to a shared list is enabled.
>
> **ingested\_user\_list\_info** `object`
>
> Mutable metadata for a list populated with ingested data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Experiment
>
> **Slug:** `GOOGLEADS_UPDATE_EXPERIMENT`
>
> Update mutable fields on one Google Ads experiment.
>
> #### Input Parameters
>
> **experiment** `object` *required*
>
> Experiment resource name and fields to update.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **update\_mask** `string`
>
> Comma-separated fields to update; generated from supplied fields when omitted.
>
> **validate\_only** `boolean`
>
> Validate the request without changing the experiment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Experiment Arms
>
> **Slug:** `GOOGLEADS_UPDATE_EXPERIMENT_ARMS`
>
> Update one or more Google Ads experiment arms.
>
> #### Input Parameters
>
> **updates** `array` *required*
>
> Experiment arm updates to execute in one request.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> Validate the updates without changing experiment arms.
>
> **partial\_failure** `boolean`
>
> Apply valid updates and report invalid operations separately.
>
> **response\_content\_type** `string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")`
>
> Return resource names only or mutable experiment-arm fields.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Call Conversions
>
> **Slug:** `GOOGLEADS_UPLOAD_CALL_CONVERSIONS`
>
> Upload offline call conversions to Google Ads, or validate them without uploading using validate\_only. Inspect partial\_failure\_error for row failures even when the request succeeds.
>
> #### Input Parameters
>
> **conversions** `array` *required*
>
> Call conversions to upload. Google validates individual conversion fields.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validate without uploading conversions. Only errors, not results, are returned. Defaults to false at Google.
>
> **partial\_failure** `boolean`
>
> Required provider flag; Google recommends true. Successful conversions are processed and invalid rows return partial\_failure\_error. False makes the batch atomic.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Click Conversions
>
> **Slug:** `GOOGLEADS_UPLOAD_CLICK_CONVERSIONS`
>
> Upload offline click conversions with optional enhanced-conversion identifiers, consent, and cart data. Restricted to existing allowlisted upload integrations; new integrations should use the Data Manager API. This records conversions unless validate\_only is true. Inspect partial\_failure\_error for row failures even on HTTP 200; validate-only does not return conversion results.
>
> #### Input Parameters
>
> **job\_id** `integer`
>
> Optional batch job ID in \[0, 2^31). If omitted, Google generates an ID in \[2^31, 2^63-1].
>
> **conversions** `array` *required*
>
> Click conversions to upload.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validate without executing; only errors, not conversion results, are returned.
>
> **partial\_failure** `boolean`
>
> Google requires this option and recommends always true: valid conversions succeed while invalid rows return errors. False requests atomic processing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Conversion Adjustments
>
> **Slug:** `GOOGLEADS_UPLOAD_CONVERSION_ADJUSTMENTS`
>
> Upload retractions, restatements, or enhancements of existing conversions. Set validate\_only=true to check without changing conversions. Inspect partial\_failure\_error even when HTTP succeeds.
>
> #### Input Parameters
>
> **job\_id** `integer`
>
> Optional batch job ID in \[0, 2^31). If omitted Google generates an ID in \[2^31, 2^63-1].
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **validate\_only** `boolean`
>
> If true, validate without executing adjustments; no results are returned. Defaults to false at the provider.
>
> **partial\_failure** `boolean`
>
> Required provider option; should always be true. Valid rows succeed and invalid rows appear in partial\_failure\_error.
>
> **conversion\_adjustments** `array` *required*
>
> Conversion adjustments to upload.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload User Data
>
> **Slug:** `GOOGLEADS_UPLOAD_USER_DATA`
>
> Append or remove already-hashed user data in a Google Ads Customer Match list. This endpoint performs real uploads: it has no validation-only or partial-failure mode. Supply consent as appropriate; per-user consent overrides list metadata. Uploads through this service are not visible in the UI's Segment members section. Requires an existing Google-approved Customer Match upload integration; new integrations should use Data Manager audience ingestion instead.
>
> #### Input Parameters
>
> **operations** `array` *required*
>
> Required list of create/remove user data operations.
>
> **customer\_id** `string`
>
> Target Google Ads customer ID for this tool call; hyphens and spaces are stripped. For MCC workflows, pass the child/sub-account ID. Defaults to the connection customer\_id.
>
> **customer\_match\_user\_list\_metadata** `object`
>
> Target Customer Match list and default consent settings.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
