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 private-alpha SaaS product. 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 signed-in user creates a revocable, tenant-scoped API key for an MCP-compatible AI client.
  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 stores encrypted OAuth tokens, selected account metadata, hashed API keys, OAuth state, idempotency records, and write audit records. Campaign and performance data is retrieved live during tool execution and is not persisted as a campaign-data warehouse.

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 (128 tools)

StoreAdOps exposes the following Google Ads tools to connected AI clients: 57 read tools and 71 write tools. Read tools never change your account; every write tool requires explicit confirmation and an idempotency key, and new campaigns are created paused by default.

Analysis, performance & anomalies11

  • readanalyze_ad_strengthAssess Google RSA ad strength and asset coverage.
  • readanalyze_bid_adjustment_opportunitiesFind Google device bid-adjustment opportunities.
  • readanalyze_impression_shareAnalyze budget- vs rank-lost Google impression share.
  • readanalyze_search_termsAnalyze search terms for opportunities and waste.
  • readanalyze_wasted_spendFind Google campaigns or keywords with wasted spend.
  • readdetect_keyword_cannibalizationDetect duplicate Google keywords competing across ad groups.
  • readexplain_performance_anomalyExplain a Google Ads performance anomaly from historical metrics.
  • readget_ad_performancePull per-ad performance metrics and comparisons.
  • readget_campaign_performancePull Google campaign performance metrics.
  • readget_conversion_action_performancePull conversion metrics by conversion action.
  • readget_pmax_asset_performanceRead PMax asset performance labels and group metrics.

Recommendations & account audit12

  • readaudit_google_accountRun a full Google Ads audit with a weighted health score.
  • readcheck_asset_coverageCheck Google Search extension/asset coverage vs best practice.
  • readcheck_conversion_tracking_healthDiagnose Google Ads conversion tracking health.
  • readget_benchmark_contextReturn benchmark context for Google Ads recommendations.
  • readget_google_recommendationsRead Google's native Ads recommendations.
  • readget_optimization_scoreRead Google account and campaign optimization scores.
  • readoptimize_budget_allocationRecommend budget shifts.
  • readprioritize_recommendationsRank recommendations into a sequenced action plan.
  • readrecommend_bid_strategyRecommend a Google bid strategy from conversion signal and economics.
  • readrecommend_negative_keywordsRecommend Google negative keywords from wasted search terms.
  • writeapply_google_recommendationApply a native Google Ads recommendation.
  • writedismiss_google_recommendationDismiss a native Google Ads recommendation.

Keyword & audience research13

  • readdiscover_existing_assetsDiscover existing Google account assets.
  • readget_business_profileReturn a stateless business profile from supplied context and account data.
  • readhelp_user_uploadShow image upload guidance for Performance Max assets.
  • readinfer_business_profileInfer a stateless business profile from campaign data.
  • readlist_google_languagesResolve Google Ads language constants.
  • readresearch_keywordsResearch keyword ideas and estimated CPCs.
  • readresolve_google_locationsResolve location names to exact Google geo target constants.
  • readsearch_audiencesSearch Google audience segments.
  • readselect_google_campaign_typeRecommend the right Google campaign type.
  • readsuggest_ad_contentSuggest Google ad copy within platform limits.
  • readvalidate_and_prepare_assetsValidate Google campaign assets.
  • readvalidate_videoValidate video inputs for Google campaign formats.
  • writesave_business_profileValidate a business profile payload without long-term strategy storage.

Conversions & measurement3

  • readlist_conversion_actionsList Google Ads conversion actions and tracking status.
  • writecreate_conversion_actionCreate a Google Ads webpage conversion action.
  • writeupdate_conversion_actionEdit mutable Google Ads conversion action settings.

Performance Max11

  • readget_pmax_audience_signalsGet audience signals for a Performance Max campaign.
  • readget_pmax_search_themesGet search themes for a Performance Max campaign.
  • readlist_pmax_asset_group_imagesList image assets linked to PMax asset groups.
  • writeadd_pmax_asset_group_imageUpload and link an image to a PMax asset group.
  • writeadd_pmax_audience_signalAdd an audience signal to a Performance Max campaign.
  • writeadd_pmax_search_themesAdd search themes to a Performance Max campaign.
  • writecreate_pmax_campaignCreate a paused Google Performance Max campaign.
  • writeremove_pmax_asset_group_imageUnlink an image from a PMax asset group.
  • writeremove_pmax_audience_signalRemove a Performance Max audience signal.
  • writeremove_pmax_search_themesRemove Performance Max search themes.
  • writeupdate_pmax_audience_signalUpdate PMax audience signal composition in place.

Display22

  • readget_display_ad_group_settingsInspect Display ad group status, bids, and targeting restrictions.
  • readget_display_audiencesList Display audience targeting criteria.
  • readget_display_demographicsList Display demographic targeting and exclusions.
  • readget_display_frequency_capsView Display campaign frequency caps.
  • readget_display_keywordsList Display contextual keyword criteria.
  • readget_display_placementsList Display managed placement criteria.
  • readget_display_topicsList Display topic targeting criteria.
  • writeadd_display_adAdd a responsive Display ad to an ad group.
  • writeadd_display_ad_groupAdd a Display ad group to an existing campaign.
  • writeadd_display_audiencesAdd audience targeting to a Display ad group.
  • writeadd_display_keywordsAdd contextual keyword targeting to a Display ad group.
  • writeadd_display_placementsAdd managed placement targeting to a Display ad group.
  • writeadd_display_topicsAdd topic targeting to a Display ad group.
  • writecreate_display_campaignCreate a paused Google Display campaign.
  • writeremove_display_adRemove a Display ad from an ad group.
  • writeremove_display_ad_groupRemove a Display ad group.
  • writeremove_display_criteriaRemove Display targeting criteria from an ad group.
  • writeupdate_display_ad_creativeUpdate Responsive Display Ad creative assets and text.
  • writeupdate_display_ad_groupUpdate Display ad group name, status, or bids.
  • writeupdate_display_campaign_scheduleUpdate Display campaign flight dates and ad schedule.
  • writeupdate_display_demographicsUpdate Display demographic exclusions.
  • writeupdate_display_frequency_capsUpdate Display campaign frequency caps.

Demand Gen & YouTube3

  • writeadd_demandgen_ad_groupAdd an ad group to an existing Demand Gen campaign.
  • writecreate_demandgen_campaignCreate a paused Google Demand Gen campaign.
  • writecreate_youtube_campaignCreate a paused YouTube campaign.

Campaign creation5

  • writeadd_search_ad_groupAdd an ad group to an existing Search campaign.
  • writeadd_search_campaign_imageAttach existing image assets to a Search campaign.
  • writecreate_adCreate a Responsive Search Ad in an existing ad group.
  • writecreate_search_campaignCreate a paused Google Search campaign.
  • writecreate_shopping_campaignCreate a Standard Shopping campaign (paused by default; status is configurable).

Keywords & negatives5

  • writeadd_keywordsAdd keywords to an existing Google ad group.
  • writeadd_negative_keywordsAdd campaign-level negative keywords.
  • writeremove_keywordsRemove keywords from an ad group.
  • writeremove_negative_keywordsRemove campaign-level negative keywords.
  • writeupdate_keywordUpdate keyword bid or status.

Audiences, targeting & schedule9

  • readget_ad_group_audiencesRead audience targeting on a Google ad group.
  • readget_ad_group_demographicsRead demographic targeting on a Google ad group.
  • readget_campaign_targetingGet campaign targeting criteria for a Google campaign.
  • writeadd_ad_group_audiencesAdd audience targeting to a Google ad group.
  • writeadd_campaign_proximityAdd campaign-level proximity radius targeting.
  • writeset_campaign_ad_scheduleSet Google campaign ad schedule windows.
  • writeset_campaign_device_bid_modifiersSet Google campaign device bid modifiers.
  • writeupdate_ad_group_demographicsUpdate ad-group demographic targeting exclusions.
  • writeupdate_location_targetingUpdate campaign location targeting mode.

Assets & extensions9

  • readlist_campaign_extensionsList campaign extensions and assets.
  • writeadd_business_name_assetAttach a business name asset to a Search campaign.
  • writeadd_call_assetAttach a phone number call asset to a Search campaign.
  • writeadd_callout_extensionsAdd Google Ads callout extensions to a campaign.
  • writeadd_sitelinksAdd sitelink extensions to a campaign.
  • writeadd_structured_snippetsAdd structured snippet extensions to a campaign.
  • writeremove_calloutsRemove callout extensions from a campaign.
  • writeremove_sitelinksRemove sitelink extensions from a campaign.
  • writeremove_structured_snippetsRemove structured snippet extensions from a campaign.

Campaign, ad group & bid management17

  • readget_ad_group_settingsRead editable settings on a Google ad group.
  • readget_ad_policy_violationsRead Google ad policy approval and violation status.
  • readget_campaign_structureReturn campaign structure with ad groups and ads.
  • readlist_campaignsList Google Ads campaigns.
  • writepause_adPause an ad.
  • writepause_ad_groupPause a Google ad group.
  • writepause_campaignPause a Google campaign.
  • writeremove_adRemove a Google ad.
  • writeremove_ad_groupRemove a Google ad group.
  • writeremove_campaignPermanently remove a paused Google campaign.
  • writeresume_adResume a paused ad.
  • writeresume_ad_groupResume a paused Google ad group.
  • writeresume_campaignResume a paused Google campaign.
  • writeupdate_ad_group_settingsUpdate editable settings on a Google ad group.
  • writeupdate_bid_strategyUpdate Google campaign bid strategy.
  • writeupdate_campaignUpdate Google campaign settings.
  • writeupdate_campaign_budgetChange a Google campaign daily budget.

Account, access & metadata4

  • readget_resource_metadataDiscover selectable, filterable, and sortable Google Ads fields.
  • readget_usage_statusReturn local usage status for Advantage MCP.
  • readlist_accessible_customersList Google Ads customer IDs accessible to the connected user.
  • readsearchRun an upstream-compatible read-only Google Ads GAQL search.

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, create or update campaigns and related resources in the account you selected.

Will it change my account without asking?

No. Every write tool requires confirmed=true and an idempotency key, and new campaigns are created paused by default so you can review before anything spends.

How is my data stored?

StoreAdOps stores encrypted OAuth tokens, selected account metadata, hashed API keys, OAuth state, idempotency records, and write audit records. Campaign and performance data is retrieved live during tool execution and is not persisted as a campaign-data warehouse.

How do I revoke access?

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