Skip to main content
Google Ads logo
  • Category: ads & conversion
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 78
  • Triggers: 0
  • Slug: GOOGLEADS
  • Version: 20261101_00

Frequently Asked Questions

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.

Tools

Slug: GOOGLEADS_ADD_OR_REMOVE_TO_CUSTOMER_LISTSubmit 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

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.
string ("create" | "remove")
Operation to perform on the customer list (UserList/audience list). Either create or remove.
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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_BATCH_MUTATECreate, 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

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.
boolean
If true, validates the request without applying changes.
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.
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.
string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls response content for a cross-resource mutate request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_CREATE_CALLOUT_ASSETCreate 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

string
Optional internal name for the immutable callout asset.
object
required
Validated callout content and optional schedule.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_CREATE_CUSTOMER_CLIENTCreate 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

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.
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.
string
User to invite to the new account. Available only to allowlisted managers; omit for ordinary account creation.
boolean
If true, validate parameters and manager eligibility without creating an account or inviting a user. Only errors, not results, are returned.
object
required
New client account’s essential settings and optional URL options.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_CREATE_CUSTOMER_LISTCreates 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

string
required
Name of the Google Ads customer list (UserList/audience list), not an account.
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.
string
Description of the Google Ads customer list (UserList/audience list), not an account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_CREATE_DATA_MANAGER_USER_LISTCreate a Data Manager user list, or validate without creating one.

Input Parameters

string
Resource identifier: accountTypes/{accountType}/accounts/{account}/userLists/{userList}.
string
required
Parent account ID, without hyphens for Google Ads.
string
Description of the user list.
string
required
Required display name of the user list.
string
Optional authorizing account resource: accountTypes/{type}/accounts/{id}.
boolean
If true, validate the request without creating a user list.
string
Optional account resource with a product link to login_account.
string
required
Parent account type, for example GOOGLE_ADS.
string
External system ID used by user list sellers.
string ("MEMBERSHIP_STATUS_UNSPECIFIED" | "OPEN" | "CLOSED")
Membership status: OPEN accrues members; CLOSED stops new members.
string
Google duration in seconds ending in s; must be an exact multiple of 86400 seconds (24 hours).
object
Eligibility information for target networks.
string ("ACCESS_STATUS_UNSPECIFIED" | "ENABLED" | "DISABLED")
Whether this account’s shared access remains enabled.
object
Information for a list populated by ingested user data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_CREATE_EXPERIMENTCreate the experiment definition that begins an experiment setup workflow. Create its control and treatment arms before scheduling it.

Input Parameters

object
required
Writable fields for the new experiment.
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.
boolean
Validate the request without creating the experiment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_CREATE_EXPERIMENT_ARMSCreate 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

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.
boolean
Validate the complete arm set without creating it.
array
required
The control and treatment arms, created atomically in one request.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Return resource names only or mutable experiment-arm fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_DELETE_DATA_MANAGER_USER_LISTDelete a Data Manager user list, optionally validating only.

Input Parameters

string
required
Required user list resource name: accountTypes/{accountType}/accounts/{account}/userLists/{userList}.
string
Optional login account resource name; defaults to the account in name.
boolean
If true, validate the request without deleting the user list.
string
Optional account resource name with an established product link to the login account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_END_EXPERIMENTImmediately stop a running experiment without deleting its campaigns, or validate that operation. Google changes the experiment’s end date to now.

Input Parameters

string
required
Experiment resource name: customers/{customer_id}/experiments/{experiment_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.
boolean
Validate ending without stopping the experiment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GENERATE_KEYWORD_FORECAST_METRICSForecast clicks, conversions and costs for a hypothetical keyword campaign without creating resources.

Input Parameters

object
required
Hypothetical campaign to forecast; does not create a campaign.
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.
string
Currency for exchange-rate conversion; defaults to the account currency.
object
Forecast dates in the customer’s timezone; defaults to next Sunday through Saturday.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GENERATE_KEYWORD_HISTORICAL_METRICSRetrieve historical search volumes, competition, and bid metrics for supplied keywords without creating or changing advertising resources.

Input Parameters

array
required
Keywords whose historical metrics to retrieve (up to 10,000). Close variants are deduplicated by Google.
string
Language resource name, such as languageConstants/1000; omitted means all languages.
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.
object
Aggregate metrics to include, such as the DEVICE breakdown.
array
Up to 10 location resource names, such as geoTargetConstants/2840. An empty list targets all geos.
string ("UNSPECIFIED" | "UNKNOWN" | "GOOGLE_SEARCH" | "GOOGLE_SEARCH_AND_PARTNERS")
Target network; defaults to Google Search and partners.
boolean
Include adult keywords in the response; defaults to false.
object
Average CPC and date-range options. Defaults to the past 12 months; up to four years of history is available.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GENERATE_KEYWORD_IDEASGenerate keyword ideas and planning metrics from exactly one seed form.

Input Parameters

string
Language constant resource name to target, for example languageConstants/1000.
object
A URL used as the sole idea seed.
integer
Number of ideas requested for this page; Google returns at most 10,000.
object
A site domain used as the sole idea seed.
string
Token returned as next_page_token by the previous page.
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.
object
Keywords or phrases used as the sole idea seed.
object
Aggregate metric breakdowns to include in the response.
array
Keyword annotation types to include in the response.
array
Up to 10 geo target constant resource names; an empty list targets all geos.
object
Keywords and a URL used together as the sole idea seed.
string ("UNSPECIFIED" | "UNKNOWN" | "GOOGLE_SEARCH" | "GOOGLE_SEARCH_AND_PARTNERS")
Google Ads network on which to generate keyword ideas.
boolean
Whether the response may include adult keywords.
object
Options controlling the returned historical metrics.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GET_CAMPAIGN_BY_IDRetrieve a Google Ads campaign’s name and status by numeric campaign ID for the specified or connected customer account.

Input Parameters

string
required
id of the campaign to search on GoogleAds.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GET_CAMPAIGN_BY_NAMERetrieve 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

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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GET_CONVERSION_ACTION_TAG_SNIPPETSRetrieve provider-generated website or call conversion tag snippets after creating a conversion action. Markup is returned exactly as Google provides it.

Input Parameters

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.
string
required
Numeric Google Ads conversion action ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GET_CONVERSION_INGESTION_STATUSRetrieve 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GET_CUSTOMER_LISTSList 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

string
Pagination token from a previous response’s next_page_token.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GET_DATA_MANAGER_USER_LISTGet one Data Manager user list without modifying it.

Input Parameters

string
required
Resource name: accountTypes/{accountType}/accounts/{account}/userLists/{userList}.
string
Optional login account resource name; defaults to the account in name.
string
Optional account resource name with an established product link to the login account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GET_EXPERIMENTGet one Google Ads experiment by resource name or numeric ID.

Input Parameters

string
required
Numeric experiment ID or full experiment resource name.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GET_EXPERIMENT_ARMGet one Google Ads experiment arm, including draft campaigns.

Input Parameters

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.
string
required
Full experiment arm resource name in the form customers/{customer_id}/experimentArms/{experiment_id}~{arm_id}.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_GET_RMF_REPORTRun 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

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.
string
Optional inclusive report end date in YYYY-MM-DD format.
integer
Maximum rows returned. The action queries one extra row and reports truncated=true instead of silently dropping results.
string
Optional inclusive report start date in YYYY-MM-DD format.
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.
array
Additional v26 metrics compatible with the selected report, such as metrics.ctr. Required columns cannot be removed. Google validates resource compatibility.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_INGEST_AD_EVENTSUpload 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

array
required
At least one ad event to upload to Google Analytics; no Google Ads destinations are supported by this endpoint.
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.
boolean
Deprecated by Google but documented: true validates without executing; false ingests advertising events irreversibly.
object
Encryption key information; required whenever an ad event contains user_data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_INGEST_AUDIENCE_MEMBERSValidate 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

Request-level consent; individual member consent overrides it.
string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")
Required for UserData uploads: encoding of the hashed string, or outer encrypted string if encrypted. Ignored for other uploads.
array
required
Destinations receiving the audience members.
boolean
True validates without executing; only errors, not results, are returned. False starts asynchronous ingestion.
object
Optional encryption for UserData. Omit for hashed, unencrypted identifiers; ignored for other uploads.
array
required
One to 10,000 audience members to ingest.
object
Explicit caller decision on applicable terms; does not automatically accept terms.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_INGEST_CONVERSION_EVENTSValidate 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

array
required
One to 2,000 conversion events to validate or ingest.
Request-level consent applied unless an event supplies its own consent.
string ("HEX" | "BASE64")
Encoding of normalized SHA-256 user identifiers; required with user data.
array
required
One to ten Google Ads destinations for this batch.
boolean
Validate without ingesting when true. False starts irreversible asynchronous processing for an accepted batch.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_INGEST_USERSIngest 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

array
required
Users to ingest; each must include both user_data and mobile_data.
string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")
required
Required user-identifier encoding; for encrypted identifiers, the outer encoding.
array
required
Accounts receiving the identity linkage data. Requires provider allowlisting.
boolean
True validates without execution. False starts asynchronous ingestion.
object
Optional encryption key information; omit for hashed, unencrypted identifiers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_LIST_ACCESSIBLE_CUSTOMERSList 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_LIST_DATA_MANAGER_CONVERSION_ACTIONSList 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

array
Statuses to include. Keep ENABLED for an ingestible destination; HIDDEN and REMOVED are primarily useful for diagnosis.
string
Select enabled UPLOAD_CLICKS actions for offline conversion ingestion.
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.
string
Optional case-insensitive literal substring of the conversion action name.
boolean
Require primary_for_goal to be true or false; omit to return both.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_LIST_DATA_MANAGER_USER_LISTSList one page of Data Manager user lists and their lifecycle configuration.

Input Parameters

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.
string
required
Account owning the collection, in accountTypes/{accountType}/accounts/{account} form.
integer
Maximum lists to return. Defaults to at most 50; Google coerces values above 1000 to 1000.
string
Token from next_page_token; keep all other parameters unchanged when continuing.
string
Optional accountTypes/{type}/accounts/{id} where the credential user has access; defaults to parent.
string
Optional accountTypes/{type}/accounts/{id} with an established product link to login-account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_LIST_EXPERIMENT_ARMSList Google Ads experiment arms, including draft campaigns.

Input Parameters

boolean
Filter control/test arms.
string
Optional experiment resource name to filter by.
string
Token returned as next_page_token by the previous page.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_LIST_EXPERIMENTSList Google Ads experiments, optionally filtered by status and type.

Input Parameters

string ("ENABLED" | "REMOVED" | "HALTED" | "PROMOTED" | "SETUP" | "INITIATED" | "GRADUATED")
Filter by status.
string
Token returned as next_page_token by the previous page.
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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_LIST_SUB_ACCOUNTSList 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

string
Pagination token from a previous response’s next_page_token.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_AD_GROUP_ADSCreate, 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

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_AD_GROUP_ASSETSCreate, 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

array
required
AdGroupAsset operations for linking assets to ad groups. Create payloads commonly include ad_group, asset, field_type, and status.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_AD_GROUP_BID_MODIFIERSCreate, update, or remove ad group bid modifiers, such as device bid adjustments or hotel-specific bid modifier criteria.

Input Parameters

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_AD_GROUP_CRITERIACreate, 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

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.
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.
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).
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.
string ("UNSPECIFIED" | "RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of the mutated resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_AD_GROUPSCreate, 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

array
required
List of ad group operations (create, update, or remove). At least one operation is required.
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.
boolean
If true, validates the request without executing. Useful for testing before making actual changes.
boolean
If true, valid operations succeed even if other operations fail. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_ADSUpdate 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

array
required
Update operations on individual ads.
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.
boolean
Validate without applying changes; only errors, not results, are returned.
boolean
If true, valid operations succeed and failed operations are reported in partial_failure_error, even with HTTP 200. Otherwise atomic.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_ASSET_GROUP_ASSETSCreate, update, or remove links between assets and Performance Max asset groups. Use this after creating compatible assets and an asset group.

Input Parameters

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}.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_ASSET_GROUPSCreate, 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

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.
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.
boolean
If true, validates the request without applying changes. Only errors are returned, not mutation results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_ASSETSCreate 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

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_ASSET_SETSCreate, 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

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}.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_AUDIENCESCreate 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

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_BIDDING_STRATEGIESCreate, 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

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_CAMPAIGN_ASSETSCreate, 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

array
required
CampaignAsset operations for linking assets to campaigns. Create payloads commonly include campaign, asset, field_type, and status.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_CAMPAIGN_BUDGETSCreate, update, or remove Google Ads campaign budgets. Use this before creating campaigns because campaign creation requires an existing campaign_budget resource name.

Input Parameters

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_CAMPAIGN_CRITERIACreate, update, or remove campaign-level targeting criteria such as locations, languages, campaign-level negative keywords, devices, schedules, audiences, and IP exclusions.

Input Parameters

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_CAMPAIGN_LABELSCreate or remove relationships between campaigns and labels. Use this after creating labels to organize campaigns for filtering and reporting.

Input Parameters

array
required
CampaignLabel operations. Create payloads include campaign and label resource names. Remove uses customers/{customer_id}/campaignLabels/{campaign_id}~{label_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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_CAMPAIGNSCreate, 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

array
required
List of campaign operations to perform. Each operation can be create, update, or remove. At least one operation is required.
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.
boolean
If true, validates the request without executing. Useful for testing before making actual changes.
boolean
If true, valid operations succeed even if others fail. Partial failures will be reported in the response.
string
Whether to return full resource or just resource name. Options: ‘RESOURCE_NAME_ONLY’ or ‘MUTABLE_RESOURCE’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_CAMPAIGNS_V2Create, 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

array
required
List of campaign operations to perform. Each operation can be create, update, or remove. At least one operation is required.
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.
boolean
If true, validates the request without executing. Useful for testing before making actual changes.
boolean
If true, valid operations succeed even if others fail. Partial failures will be reported in the response.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_CONVERSION_ACTIONSCreate, 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

array
required
ConversionAction operations. Common fields include name, status, type, category, primary_for_goal, lookback windows, value_settings, counting_type, and attribution_model_settings.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_CUSTOM_AUDIENCESCreate, update, or remove Google Ads custom audiences used to reach users by interests, searches, visited URLs, place categories, or installed apps.

Input Parameters

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}.
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.
boolean
If true, validates the request without applying changes.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_CUSTOMERUpdate 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

object
required
The single customer update operation to perform.
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.
boolean
If true, validates without applying changes; no result is returned.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_CUSTOMER_ASSETSCreate 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

array
required
CustomerAsset operations for associating assets with a customer or removing existing customer-level associations.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_KEYWORD_PLAN_AD_GROUP_KEYWORDSCreate, 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

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_KEYWORD_PLAN_AD_GROUPSCreate, 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

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_KEYWORD_PLAN_CAMPAIGN_KEYWORDSCreate, 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

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_KEYWORD_PLAN_CAMPAIGNSCreate, 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

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_KEYWORD_PLANSCreate, 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

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.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_LABELSCreate, update, or remove Google Ads labels. Pair this with campaign label mutations to organize campaigns and support filtering.

Input Parameters

array
required
Label operations. Common fields include name and text_label with background_color and description.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_PORTFOLIO_BIDDING_STRATEGIESCreate, 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

array
required
Typed Target CPA or Target ROAS portfolio strategy operations.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Controls how much of each mutated Google Ads resource is returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_SHARED_CRITERIACreate or remove criteria in a Google Ads shared set, such as negative keywords or excluded placements shared across campaigns.

Input Parameters

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}.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_SHARED_SETSCreate, update, or remove Google Ads shared sets used to group shared criteria, such as negative keyword lists, for reuse across campaigns.

Input Parameters

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}.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_MUTATE_USER_LISTSCreate, update, or remove general Google Ads user-list resources used for audience targeting and remarketing.

Input Parameters

array
required
UserList operations. Create and update accept Google Ads UserList fields; updates include resource_name, and remove uses a user-list resource name.
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.
boolean
If true, validates the request without applying changes.
boolean
If true, valid operations succeed even when other operations fail. Invalid operations are returned in partial_failure_error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_REMOVE_ALL_AUDIENCE_MEMBERSValidate or asynchronously remove all members of Data Manager audiences.

Input Parameters

array
required
Destinations from which to remove all audience members.
boolean
When true, validate without removing members; only errors are returned.
string
RFC 3339 timestamp, not in the future. Only members last added before this time are removed. Omit to use the current time.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_REMOVE_AUDIENCE_MEMBERSRemove 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

string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")
Required for user data; outer encoding if encrypted. Ignored for other data types.
array
required
Destinations from which to remove users.
boolean
True validates without removal; only errors, not results, are returned. Omitted/false executes removal.
object
User-data encryption details; omit for hashed but unencrypted identifiers.
array
required
Audience members to remove; does not remove the list itself.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_REMOVE_USERSRemove 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

string ("ENCODING_UNSPECIFIED" | "HEX" | "BASE64")
required
Required encoding of user identifiers; for encrypted identifiers, the outer encoding.
array
required
UserData keys identifying users to remove; not AudienceMember objects or mobile IDs.
array
required
Destinations from which the identified users are removed.
boolean
True validates without execution; omitted or false submits asynchronous removal.
object
Encryption key information; omit for unencrypted hashed identifiers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_SCHEDULE_EXPERIMENTSchedule 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

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.
string
required
Experiment resource name: customers/{customer_id}/experiments/{experiment_id}.
boolean
Validate scheduling without materializing the experiment campaign.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_SEARCH_GAQLRun one page of a GAQL search and return its continuation token.

Input Parameters

string
required
The Google Ads Query Language (GAQL) query to run.
string
Token from next_page_token in the preceding search response.
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.
boolean
If true, validate the query without executing it.
object
Optional controls for result counts, summary rows, and rows.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_SEARCH_GOOGLE_ADS_FIELDSSearch the Google Ads v26 field metadata catalog with GAQL.

Input Parameters

string
required
GAQL metadata query selecting Google Ads field attributes. For example, SELECT name, category, data_type, selectable WHERE name LIKE ‘campaign.%’.
integer
Maximum field definitions to request in this page. Google may return fewer results than requested.
string
Token returned as next_page_token by the previous page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_SEARCH_STREAM_GAQLExecute 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

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’
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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_UPDATE_DATA_MANAGER_USER_LISTUpdate mutable Data Manager user-list metadata, optionally validating only.

Input Parameters

string
required
Account ID owning the user list.
string
Description; an empty string clears the description.
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.
string
required
Account type, for example GOOGLE_ADS.
string
New display name. Omit when updating other fields.
string
required
ID of the user list to update.
string
Optional authorizing account resource: accountTypes/{type}/accounts/{id}.
boolean
If true, validate the request without updating the list.
string
Optional linked account resource: accountTypes/{type}/accounts/{id}.
string
External-system identifier used by user-list sellers.
string ("MEMBERSHIP_STATUS_UNSPECIFIED" | "OPEN" | "CLOSED")
Whether this list accepts new members.
string
Protobuf duration in seconds, ending in s; exact multiples of 86400 seconds.
object
Mutable target-network eligibility information.
string ("ACCESS_STATUS_UNSPECIFIED" | "ENABLED" | "DISABLED")
Whether the account’s access to a shared list is enabled.
object
Mutable metadata for a list populated with ingested data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_UPDATE_EXPERIMENTUpdate mutable fields on one Google Ads experiment.

Input Parameters

object
required
Experiment resource name and fields to update.
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.
string
Comma-separated fields to update; generated from supplied fields when omitted.
boolean
Validate the request without changing the experiment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_UPDATE_EXPERIMENT_ARMSUpdate one or more Google Ads experiment arms.

Input Parameters

array
required
Experiment arm updates to execute in one request.
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.
boolean
Validate the updates without changing experiment arms.
boolean
Apply valid updates and report invalid operations separately.
string ("RESOURCE_NAME_ONLY" | "MUTABLE_RESOURCE")
Return resource names only or mutable experiment-arm fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_UPLOAD_CALL_CONVERSIONSUpload 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

array
required
Call conversions to upload. Google validates individual conversion fields.
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.
boolean
If true, validate without uploading conversions. Only errors, not results, are returned. Defaults to false at Google.
boolean
Required provider flag; Google recommends true. Successful conversions are processed and invalid rows return partial_failure_error. False makes the batch atomic.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_UPLOAD_CLICK_CONVERSIONSUpload 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

integer
Optional batch job ID in [0, 2^31). If omitted, Google generates an ID in [2^31, 2^63-1].
array
required
Click conversions to upload.
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.
boolean
If true, validate without executing; only errors, not conversion results, are returned.
boolean
Google requires this option and recommends always true: valid conversions succeed while invalid rows return errors. False requests atomic processing.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_UPLOAD_CONVERSION_ADJUSTMENTSUpload 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

integer
Optional batch job ID in [0, 2^31). If omitted Google generates an ID in [2^31, 2^63-1].
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.
boolean
If true, validate without executing adjustments; no results are returned. Defaults to false at the provider.
boolean
Required provider option; should always be true. Valid rows succeed and invalid rows appear in partial_failure_error.
array
required
Conversion adjustments to upload.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEADS_UPLOAD_USER_DATAAppend 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

array
required
Required list of create/remove user data operations.
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.
object
Target Customer Match list and default consent settings.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not