Documentation & trust

Product and API use

Google Ads API and StoreAdOps

StoreAdOps is a hosted SaaS product and secure tool service for merchants, advertisers, and agencies that own or are authorized to manage Google Ads accounts.

Business model

StoreAdOps is currently offered as a free hosted SaaS product with open signup. Paid subscription plans and external billing are not active. StoreAdOps does not sell advertising inventory, purchase media, or operate as an advertising agency. Users remain responsible for their own Google Ads accounts, budgets, and confirmed changes.

How a user connects Google Ads

  1. The user signs in to StoreAdOps.
  2. The user authorizes Google OAuth and grants the Google Ads scope.
  3. StoreAdOps lists only Google Ads customer accounts accessible to that user, and the user selects an account.
  4. The user connects an AI client using platform-managed browser OAuth where supported, or a revocable, tenant-scoped API key. The setup guide explains both paths.
  5. The client can request reporting or account operations only for the connected user's authorized account.

Google Ads API use cases

Read workflows include campaign structure and performance, search terms, budgets, bidding, assets, targeting, conversion configuration, recommendations, and account metadata.

Management workflows include user-confirmed campaign and resource creation, updates, pauses, negative keywords, assets, and related account operations. New campaigns are created paused by default.

Safety and authorization controls

Data handling

StoreAdOps retrieves campaign and performance data live rather than accumulating a campaign-data warehouse. It stores encrypted OAuth tokens, selected account metadata, hashed API keys, OAuth state, usage counters, and audit and idempotency records. When growth-analysis features are enabled, bounded encrypted snapshots may be retained with a 30-day expiration; some operational and safety records are retained longer. See the privacy policy for retention and deletion details.

Google user data is not sold and is not used to train general AI models. Users can revoke access in their Google Account and request deletion through support@storeadops.ai.

Review and support

The production service is available at app.storeadops.ai. Authenticated reviewer access and additional technical evidence can be provided securely by contacting support@storeadops.ai.

Google Ads tools (100 provider tools)

StoreAdOps exposes the following Google Ads tools to connected AI clients:

Generated from the current named-tool registry. Every callable input schema is exposed in tools/list; get_capabilities reports account readiness only. Availability depends on connected accounts, permissions, assets and enabled features. Server exposure does not establish approval or availability in an installed ChatGPT or Claude client.

Read and analyze (44)

Bounded reads of account, campaign or commerce data. These tools do not change advertising or store resources.

verify_connection

Verify connection. Performs a live metadata-only check; never selects an account or changes authorization. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, shopify, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_ad_accounts

Get ad accounts. Supported channels: amazon, google, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_campaigns

Get campaigns. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_campaign_groups

Get campaign groups (ad group, asset group, line item). Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_ads

Get ads. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_keywords

Get keywords. Supported channels: amazon, google, microsoft; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_asset_links

Get asset links. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_creative_assets

Get creative assets. Supported channels: google, meta, pinterest, reddit, snapchat, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_media

Get media. Supported channels: google, meta, microsoft, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_conversion_actions

Get conversion actions. Supported channels: google, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_product_groups

Get product groups. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_targeting_criteria

Get targeting criteria. Supported channels: google, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_targeting_options

Get targeting options. Supported channels: google, meta, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

resolve_locations

Resolve locations. Supported channels: google, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_languages

Get languages. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

research_keywords

Research keywords. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

query_google_ads

Query google ads. Bounded read-only GAQL SELECT only; no mutations, arbitrary HTTP methods or provider paths. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_google_ads_fields

Get google ads fields. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_usage_status

Read StoreAdOps runtime usage and quota-configuration information for a connected Google Ads account. Returns local tracking/configuration flags and reference plan information; usage counters and reset dates are unavailable, not live Google Ads quotas or ad spend. Does not verify a hosted subscription or change billing. Read-only.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_performance

Get performance. Synchronous metrics only; never starts an asynchronous report job. Supported channels: google, meta, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_asset_performance

Get asset performance. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_conversion_performance

Get conversion performance. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

audit_ad_account

Audit ad account. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

analyze_wasted_spend

Analyze wasted spend. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

check_conversion_tracking

Check conversion tracking. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

analyze_ad_strength

Analyze ad strength. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

find_bid_adjustment_opportunities

Find bid adjustment opportunities. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

analyze_impression_share

Analyze impression share. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

analyze_search_terms

Analyze search terms. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

check_asset_coverage

Check asset coverage. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

detect_keyword_cannibalization

Detect keyword cannibalization. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_budget_allocation_evidence

Get budget allocation evidence. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_bid_strategy_evidence

Get bid strategy evidence. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_performance_anomaly_evidence

Get performance anomaly evidence. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_business_profile_evidence

Infer a stateless business profile from bounded Google Ads campaign names, keywords, ad copy and spend evidence. Returns StoreAdOps heuristic inferences with confidence, reasoning and supporting evidence, not a verified Google Business Profile. Read-only: never saves a profile.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_ad_copy_evidence

Get ad copy evidence. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_campaign_type_evidence

Get campaign type evidence. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_negative_keyword_evidence

Get negative keyword evidence. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_benchmark_context

Get benchmark context. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_native_recommendations

Get native recommendations. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_optimization_score

Get optimization score. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

get_business_profile

Get business profile. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

validate_creative_assets

Validate creative assets. Supported channels: google, meta; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.

validate_video

Validate video. Supported channels: google; only the provider/resource/profile variants in this schema. Read-only and bounded. Complete input contracts are in this schema; readiness discovery is optional and grants no authorization. Preserves provider facts, partial coverage and computed-evidence labels.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords.
Prepare changes (28)

Validates inputs, reads relevant state and saves a preview plan in StoreAdOps. Preparation does not perform the proposed advertising change.

prepare_create_google_campaign

Preview creation of a Google Ads campaign in the connected account. Validates the requested resources and reads relevant current state, then saves an account-bound plan with its exact preview, plan_ref and required acceptance effects; no advertising resources are created during preparation. Proposed execution: Create one Search, Display, Performance Max, Standard Shopping or Demand Gen campaign and its schema-selected budget, targeting, ad/asset groups, ads, keywords and assets. Campaigns are paused by default. Standard Shopping may be created active only when google_shopping.initial_status=active is explicitly supplied and its start-spend effects are approved; this can begin delivery and spending. After user review, call create_google_campaign with the same typed change, plan_ref, confirmed=true, accepted_effects and an idempotency_key.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_update_google_campaign

Preview changes to one Google Ads campaign in the connected account. Reads current state and saves an account-bound plan with its exact preview, plan_ref and required acceptance effects; no advertising changes occur during preparation. Proposed execution: Update one Search, Display, Performance Max, Standard Shopping or Demand Gen campaign. Supported fields vary by campaign type and include its name, budget, bidding, geo settings, targeting and asset links; Display also supports flight dates and frequency caps. Budget, bidding, targeting or schedule changes can affect delivery and spend. Shared-budget changes can affect other campaigns using that budget and require the explicit supported approval field. After user review, call update_google_campaign with the same typed change, plan_ref, confirmed=true, accepted_effects and an idempotency_key.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_create_campaign_group

Prepare create campaign group: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: paused_create Create one paused group in its referenced campaign. After review call create_campaign_group with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_update_campaign_group

Prepare update campaign group: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: patch_may_change_delivery Update supported group name, budget, bid, configuration, targeting or status. Activation may enable advertising spend. After review call update_campaign_group with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_create_ad

Prepare create ad: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: paused_create Create one paused ad with an explicit format and typed creative. After review call create_ad with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_update_ad

Prepare update ad: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: patch_may_change_delivery Update supported ad content or status. Activation may enable advertising spend. After review call update_ad with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_add_keywords

Prepare add keywords: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, microsoft; only the provider/resource/profile variants in this schema. Proposed effects: Add paused keywords with explicit kind, match type and currency-qualified bids. After review call add_keywords with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_update_keywords

Prepare update keywords: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, microsoft; only the provider/resource/profile variants in this schema. Proposed effects: Update keyword bids or statuses, with individual outcomes. Activation may enable spend. After review call update_keywords with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_pause_campaigns

Prepare pause campaigns: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. After review call pause_campaigns with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_resume_campaigns

Prepare resume campaigns: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. After review call resume_campaigns with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_remove_campaigns

Prepare remove campaigns: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. After review call remove_campaigns with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_pause_campaign_groups

Prepare pause campaign groups (ad group, asset group, line item): read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. After review call pause_campaign_groups with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_resume_campaign_groups

Prepare resume campaign groups (ad group, asset group, line item): read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Proposed effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. After review call resume_campaign_groups with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_remove_campaign_groups

Prepare remove campaign groups (ad group, asset group): read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. After review call remove_campaign_groups with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_pause_ads

Prepare pause ads: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. After review call pause_ads with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_resume_ads

Prepare resume ads: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. After review call resume_ads with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_remove_ads

Prepare remove ads: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. After review call remove_ads with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_pause_keywords

Prepare pause keywords: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, microsoft; only the provider/resource/profile variants in this schema. Proposed effects: Pause a bounded set of entities in one account. Returns individual outcomes. After review call pause_keywords with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_resume_keywords

Prepare resume keywords: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, microsoft; only the provider/resource/profile variants in this schema. Proposed effects: Activate a bounded set of entities; this may enable advertising spend. After review call resume_keywords with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_remove_keywords

Prepare remove keywords: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: amazon, google, microsoft; only the provider/resource/profile variants in this schema. Proposed effects: Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. After review call remove_keywords with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_remove_targeting_criteria

Prepare remove targeting criteria: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: google; only the provider/resource/profile variants in this schema. Proposed effects: Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. After review call remove_targeting_criteria with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_unlink_campaign_assets

Prepare unlink campaign assets: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: google; only the provider/resource/profile variants in this schema. Proposed effects: Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. After review call unlink_campaign_assets with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_replace_product_group

Prepare replace product group: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: google; only the provider/resource/profile variants in this schema. Proposed effects: Atomically subdivide a selected Shopping UNIT into biddable leaves and an Other leaf, or collapse a selected SUBDIVISION into one UNIT. The old listing subtree is removed and new IDs are assigned. After review call replace_product_group with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_apply_recommendation

Preview applying one native Google Ads recommendation for the connected account. Use its provider resource name from get_native_recommendations, not a StoreAdOps heuristic ID. Reads current state and saves an account-bound plan with a preview, plan_ref and required acceptance effects; no Google Ads changes occur during preparation. Applying can change provider-defined account resources, delivery and spend; exact effects may be unknown. Provider acceptance may remain pending and unverified; do not claim completion without verified readback. After user review, call apply_recommendation with the same typed change, plan_ref, confirmed=true, accepted_effects and an idempotency_key.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Not currently enabled; disabled features: google_ads_recommendation_apply_enabled.

prepare_dismiss_recommendation

Preview dismissing one native Google Ads recommendation for the connected account. Use its provider resource name from get_native_recommendations, not a StoreAdOps heuristic ID. Reads current state and saves an account-bound plan with a preview, plan_ref and required acceptance effects; no Google Ads changes occur during preparation. Dismissal marks the native recommendation dismissed; it does not apply its proposed changes or undo a prior application. After user review, call dismiss_recommendation with the same typed change, plan_ref, confirmed=true, accepted_effects and an idempotency_key.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Not currently enabled; disabled features: google_ads_recommendation_apply_enabled.

prepare_create_conversion_action

Prepare create conversion action: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: google, x; only the provider/resource/profile variants in this schema. Proposed effects: Create one Google webpage conversion action with explicit goal, attribution, lookback, and optional value settings. A primary goal may affect automated bidding. Create one X website event tag (conversion action) with its type, click and view-through attribution windows and retargeting setting. It changes no campaign; a line item counts it only when it is the line item's primary web event tag. After review call create_conversion_action with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_update_conversion_action

Prepare update conversion action: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: google, x; only the provider/resource/profile variants in this schema. Proposed effects: Patch mutable settings of one account-owned Google webpage conversion action. This may change account conversion measurement or bidding. Patch the supplied settings of one X website event tag; omitted settings are kept. A type or window change alters how X counts conversions for line items that use the tag, which can affect their optimization. After review call update_conversion_action with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

prepare_upload_media

Prepare upload media: read current state and store an exact account-bound plan for user review. Creates StoreAdOps state but does not perform the advertising change. Supported channels: google, meta, microsoft, openai, snapchat, tiktok; only the provider/resource/profile variants in this schema. Proposed effects: library_upload Upload one image from a public HTTPS URL to the account's media library and return its media ID for creatives. After review call upload_media with the exact same typed change supplied to preparation, plan_ref, confirmed=true and accepted_effects.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.
Execute confirmed changes (28)

Requires the matching prepared plan, the exact change, explicit confirmation, accepted effects and an idempotency key. Activation and resume actions can start delivery and spending.

create_google_campaign

Create one Search, Display, Performance Max, Standard Shopping or Demand Gen campaign and its schema-selected budget, targeting, ad/asset groups, ads, keywords and assets. Campaigns are paused by default. Standard Shopping may be created active only when google_shopping.initial_status=active is explicitly supplied and its start-spend effects are approved; this can begin delivery and spending. Execute only the exact typed change reviewed through prepare_create_google_campaign. Requires its plan_ref, confirmed=true after user review, exact accepted_effects and an idempotency_key. Confirmation is a host assertion, not proof of consent. Same-key replay returns the durable outcome; never retry a partial or uncertain creation with a new key. Account, profile, grants, feature gates and provider readback checks still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

update_google_campaign

Update one Search, Display, Performance Max, Standard Shopping or Demand Gen campaign. Supported fields vary by campaign type and include its name, budget, bidding, geo settings, targeting and asset links; Display also supports flight dates and frequency caps. Budget, bidding, targeting or schedule changes can affect delivery and spend. Shared-budget changes can affect other campaigns using that budget and require the explicit supported approval field. Execute only the exact typed change reviewed through prepare_update_google_campaign. Requires its plan_ref, confirmed=true after user review, exact accepted_effects and an idempotency_key. Confirmation is a host assertion, not proof of consent. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants, feature gates and provider readback checks still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

create_campaign_group

Create campaign group using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: paused_create Create one paused group in its referenced campaign. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

update_campaign_group

Update campaign group using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: patch_may_change_delivery Update supported group name, budget, bid, configuration, targeting or status. Activation may enable advertising spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

create_ad

Create ad using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: paused_create Create one paused ad with an explicit format and typed creative. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

update_ad

Update ad using the exact typed change and its immutable prepared plan. Supported channels: google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: patch_may_change_delivery Update supported ad content or status. Activation may enable advertising spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

add_keywords

Add keywords using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, microsoft; only the provider/resource/profile variants in this schema. Effects: Add paused keywords with explicit kind, match type and currency-qualified bids. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

update_keywords

Update keywords using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, microsoft; only the provider/resource/profile variants in this schema. Effects: Update keyword bids or statuses, with individual outcomes. Activation may enable spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

pause_campaigns

Pause campaigns using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

resume_campaigns

Resume campaigns using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

remove_campaigns

Remove campaigns using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

pause_campaign_groups

Pause campaign groups (ad group, asset group, line item) using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

resume_campaign_groups

Resume campaign groups (ad group, asset group, line item) using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok, x; only the provider/resource/profile variants in this schema. Effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

remove_campaign_groups

Remove campaign groups (ad group, asset group) using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

pause_ads

Pause ads using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: pause_stops_delivery Pause a bounded set of entities in one account. Returns individual outcomes. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

resume_ads

Resume ads using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: resume_may_start_spend Activate a bounded set of entities; this may enable advertising spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

remove_ads

Remove ads using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, meta, microsoft, openai, pinterest, reddit, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: soft_delete_stops_delivery Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

pause_keywords

Pause keywords using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, microsoft; only the provider/resource/profile variants in this schema. Effects: Pause a bounded set of entities in one account. Returns individual outcomes. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

resume_keywords

Resume keywords using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, microsoft; only the provider/resource/profile variants in this schema. Effects: Activate a bounded set of entities; this may enable advertising spend. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

remove_keywords

Remove keywords using the exact typed change and its immutable prepared plan. Supported channels: amazon, google, microsoft; only the provider/resource/profile variants in this schema. Effects: Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

remove_targeting_criteria

Remove targeting criteria using the exact typed change and its immutable prepared plan. Supported channels: google; only the provider/resource/profile variants in this schema. Effects: Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

unlink_campaign_assets

Unlink campaign assets using the exact typed change and its immutable prepared plan. Supported channels: google; only the provider/resource/profile variants in this schema. Effects: Remove entities using the discovered channel semantics (delete or archive). Discover supported entity types first. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply. For variants with entity_refs: Array of opaque entity_ref strings from the matching get_* tool for this account and entity type (for example get_campaigns or get_ads). Copy the references unchanged; do not use native_id, campaign IDs, names, or resource paths.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

replace_product_group

Replace product group using the exact typed change and its immutable prepared plan. Supported channels: google; only the provider/resource/profile variants in this schema. Effects: Atomically subdivide a selected Shopping UNIT into biddable leaves and an Other leaf, or collapse a selected SUBDIVISION into one UNIT. The old listing subtree is removed and new IDs are assigned. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

apply_recommendation

Apply one native Google Ads recommendation for the connected account using its exact typed change and prepared plan. Use its provider resource name from get_native_recommendations, not a StoreAdOps heuristic ID. Applying can change provider-defined account resources, delivery and spend; exact effects may be unknown. Provider acceptance may remain pending and unverified; do not claim completion without verified readback. Requires plan_ref from the matching preparation tool, confirmed=true after user review, exact accepted_effects and an idempotency_key. Confirmation is a host assertion, not proof of consent. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account ownership, feature gates, grants and provider readback checks still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Not currently enabled; disabled features: google_ads_recommendation_apply_enabled.

dismiss_recommendation

Dismiss one native Google Ads recommendation for the connected account using its exact typed change and prepared plan. Use its provider resource name from get_native_recommendations, not a StoreAdOps heuristic ID. Dismissal marks the native recommendation dismissed; it does not apply its proposed changes or undo a prior application. Requires plan_ref from the matching preparation tool, confirmed=true after user review, exact accepted_effects and an idempotency_key. Confirmation is a host assertion, not proof of consent. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account ownership, feature gates, grants and provider readback checks still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Not currently enabled; disabled features: google_ads_recommendation_apply_enabled.

create_conversion_action

Create conversion action using the exact typed change and its immutable prepared plan. Supported channels: google, x; only the provider/resource/profile variants in this schema. Effects: Create one Google webpage conversion action with explicit goal, attribution, lookback, and optional value settings. A primary goal may affect automated bidding. Create one X website event tag (conversion action) with its type, click and view-through attribution windows and retargeting setting. It changes no campaign; a line item counts it only when it is the line item's primary web event tag. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

update_conversion_action

Update conversion action using the exact typed change and its immutable prepared plan. Supported channels: google, x; only the provider/resource/profile variants in this schema. Effects: Patch mutable settings of one account-owned Google webpage conversion action. This may change account conversion measurement or bidding. Patch the supplied settings of one X website event tag; omitted settings are kept. A type or window change alters how X counts conversions for line items that use the tag, which can affect their optimization. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.

upload_media

Upload media using the exact typed change and its immutable prepared plan. Supported channels: google, meta, microsoft, openai, snapchat, tiktok; only the provider/resource/profile variants in this schema. Effects: library_upload Upload one image from a public HTTPS URL to the account's media library and return its media ID for creatives. The user must have reviewed the exact preview before confirmed=true. Confirmation is a host assertion, not proof of consent. Rejects another action, resource family, channel or changed payload. Exact accepted_effects and an idempotency_key are required. Same-key replay returns the durable outcome; never retry an uncertain write with a new key. Account, profile, grants and provider readback still apply.

  • Requires granted scopes: https://www.googleapis.com/auth/adwords. Feature flags enabled; account permissions and provider eligibility are still required.
Shared StoreAdOps workflow tools (4)

These workspace tools are separate from the provider count above; they do not add advertising or commerce permissions.

get_connections_status
Check connected accounts and the selected account before starting.
get_capabilities
Check account readiness for already advertised tools; this does not grant access.
get_merchant_profile
Read the merchant objectives and guardrails saved in StoreAdOps.
get_change_status
Check a saved change's status and available readback; never retries a provider write.

A shared tool can support more than one platform, so platform counts should not be added together. Advertising changes require a preview, explicit confirmation and an idempotency key; listing a tool is not permission to execute it.

Frequently asked questions

What can StoreAdOps do with my Google Ads account?

After you authorize Google OAuth, connected AI clients can read reporting and account structure and, only with your explicit confirmation or a disclosed approval, create or update campaigns and related resources in the account you selected.

Will it change my account without asking?

No. Direct write tools require confirmed=true; approval-backed executions require separately validated execution authority. All provider writes require an idempotency key, and new campaigns are created paused by default so you can review before anything spends.

How is my data stored?

StoreAdOps retrieves campaign and performance data live rather than accumulating a campaign-data warehouse. It stores encrypted OAuth tokens, selected account metadata, hashed API keys, OAuth state, usage counters, and audit and idempotency records. When growth-analysis features are enabled, bounded encrypted snapshots may be retained with a 30-day expiration; some operational and safety records are retained longer. See the privacy policy for retention and deletion details.

How do I revoke access?

You can revoke access from your Google Account permissions at any time and request deletion through support@storeadops.ai.