Google Ads

List ads for a Google Ads customer account. Args: - customerId: The customer ID - adGroupId: Filter by ad group ID (optional) - pageSize: Number of ads to return (1-100, default: 50) - pageToken: Pagination token from previous response - format: Response format ('json' or 'markdown') Returns: Paginated list of ads with type, status, and URLs.

List ad groups for a Google Ads customer account. Args: - customerId: The customer ID - campaignId: Filter by campaign ID (optional) - pageSize: Number of ad groups to return (1-100, default: 50) - pageToken: Pagination token from previous response - format: Response format ('json' or 'markdown') Returns: Paginated list of ad groups with status, type, and bids.

Get details for a specific ad group. Args: - customerId: The customer ID - adGroupId: The ad group ID - format: Response format Returns: Ad group details including status, type, campaign, and bids.

Create a new ad group. Args: - customerId: The customer ID - campaignResourceName: Resource name of the parent campaign - name: Ad group name - status: Initial status (ENABLED, PAUSED) - defaults to ENABLED - type: Ad group type (SEARCH_STANDARD, DISPLAY_STANDARD, etc.) - cpcBidDollars: Default CPC bid in dollars - cpmBidDollars: Default CPM bid in dollars - targetCpaDollars: Target CPA in dollars Returns: The created ad group.

Update an existing ad group. Args: - customerId: The customer ID - adGroupId: The ad group ID - name: New ad group name - status: New status (ENABLED, PAUSED, REMOVED) - cpcBidDollars: New CPC bid in dollars - cpmBidDollars: New CPM bid in dollars - targetCpaDollars: New target CPA in dollars Returns: The updated ad group.

Pause an ad group. Args: - customerId: The customer ID - adGroupId: The ad group ID Returns: The paused ad group.

Enable (unpause) an ad group. Args: - customerId: The customer ID - adGroupId: The ad group ID Returns: The enabled ad group.

Get details for a specific ad. Args: - customerId: The customer ID - adGroupId: The ad group ID - adId: The ad ID - format: Response format Returns: Ad details including type, status, and creative content.

Create a new responsive search ad. Responsive Search Ads automatically test different headline and description combinations to find the best performing combinations for each search query. Args: - customerId: The customer ID - adGroupResourceName: Resource name of the parent ad group - headlines: Array of headline texts (3-15 headlines, max 30 chars each) - descriptions: Array of description texts (2-4 descriptions, max 90 chars each) - finalUrls: Array of landing page URLs - path1: Display URL path 1 (optional, max 15 chars) - path2: Display URL path 2 (optional, max 15 chars) Returns: The created responsive search ad.

Pause an ad. Args: - customerId: The customer ID - adGroupId: The ad group ID - adId: The ad ID Returns: The paused ad.

Enable (unpause) an ad. Args: - customerId: The customer ID - adGroupId: The ad group ID - adId: The ad ID Returns: The enabled ad.

List assets for a Google Ads customer account. Assets are reusable creative elements like text, images, and videos that can be used across multiple ads and campaigns. Args: - customerId: The customer ID - assetType: Filter by asset type (optional) - pageSize: Number of assets to return (1-100, default: 50) - pageToken: Pagination token from previous response - format: Response format ('json' or 'markdown') Returns: Paginated list of assets with type and name.

Get details for a specific asset. Args: - customerId: The customer ID - assetId: The asset ID - format: Response format Returns: Asset details including type, name, and content.

List audiences for a Google Ads customer account. Audiences are groups of users defined by their interests, behaviors, or demographics that can be targeted in campaigns. Args: - customerId: The customer ID - pageSize: Number of audiences to return (1-100, default: 50) - pageToken: Pagination token from previous response - format: Response format ('json' or 'markdown') Returns: Paginated list of audiences with name, description, and status.

Get details for a specific audience. Args: - customerId: The customer ID - audienceId: The audience ID - format: Response format Returns: Audience details including name, description, and status.

List user lists (remarketing lists) for a Google Ads customer account. User lists are collections of users who have interacted with your business, such as website visitors or customer email lists. Args: - customerId: The customer ID - pageSize: Number of user lists to return (1-100, default: 50) - pageToken: Pagination token from previous response - format: Response format ('json' or 'markdown') Returns: Paginated list of user lists with type, size, and status.

Get details for a specific user list. Args: - customerId: The customer ID - userListId: The user list ID - format: Response format Returns: User list details including type, size, membership life span, and status.

Add multiple keywords to an ad group in a single operation. Args: - customerId: The customer ID - adGroupResourceName: Resource name of the ad group - keywords: Array of keyword objects with text, matchType, and optional cpcBidDollars Returns: Array of created keywords.

List portfolio bidding strategies for a Google Ads customer account. Portfolio bidding strategies are shared strategies that can be applied to multiple campaigns. Args: - customerId: The customer ID - pageSize: Number of strategies to return (1-100, default: 50) - pageToken: Pagination token from previous response - format: Response format ('json' or 'markdown') Returns: Paginated list of bidding strategies with type, status, and campaign count.

Get details for a specific portfolio bidding strategy. Args: - customerId: The customer ID - biddingStrategyId: The bidding strategy ID - format: Response format Returns: Bidding strategy details including type, targets, and campaign count.

List all campaign budgets for a Google Ads customer account. Args: - customerId: The customer ID - pageSize: Number of budgets to return (1-100, default: 50) - pageToken: Pagination token from previous response - format: Response format ('json' or 'markdown') Returns: Paginated list of campaign budgets with amount and delivery method.

Get details for a specific campaign budget. Args: - customerId: The customer ID - budgetId: The budget ID - format: Response format Returns: Budget details including amount, delivery method, and status.

Create a new campaign budget. Args: - customerId: The customer ID - name: Budget name (optional) - amountDollars: Daily budget amount in dollars (e.g., 50.00) - deliveryMethod: How the budget is spent (STANDARD or ACCELERATED) - explicitlyShared: Whether budget can be shared across campaigns Returns: The created budget with its resource name for use in campaign creation.

Update a campaign budget amount. Args: - customerId: The customer ID - budgetId: The budget ID - amountDollars: New daily budget amount in dollars Returns: The updated budget.

List all campaigns for a Google Ads customer account. Args: - customerId: The customer ID - pageSize: Number of campaigns to return (1-100, default: 50) - pageToken: Pagination token from previous response - format: Response format ('json' or 'markdown') Returns: Paginated list of campaigns with status, channel type, and bidding strategy.

Get details for a specific campaign. Args: - customerId: The customer ID - campaignId: The campaign ID - format: Response format Returns: Full campaign details including budget, dates, and bidding configuration.

Create a new campaign. Args: - customerId: The customer ID - name: Campaign name - advertisingChannelType: Channel type (SEARCH, DISPLAY, SHOPPING, VIDEO, PERFORMANCE_MAX, etc.) - budgetResourceName: Resource name of the campaign budget (e.g., "customers/123/campaignBudgets/456") - status: Initial status (ENABLED, PAUSED) - defaults to PAUSED - startDate: Start date (YYYY-MM-DD) - endDate: End date (YYYY-MM-DD) - biddingStrategyType: Bidding strategy (MANUAL_CPC, MAXIMIZE_CONVERSIONS, TARGET_CPA, etc.) - targetCpa: Target CPA in dollars (for TARGET_CPA strategy) - targetRoas: Target ROAS as decimal (for TARGET_ROAS strategy) Returns: The created campaign.

Remove a keyword from an ad group. Args: - customerId: The customer ID - adGroupId: The ad group ID - criterionId: The keyword criterion ID Returns: Confirmation of removal.

Update an existing campaign. Args: - customerId: The customer ID - campaignId: The campaign ID - name: New campaign name - status: New status (ENABLED, PAUSED, REMOVED) - startDate: New start date (YYYY-MM-DD) - endDate: New end date (YYYY-MM-DD) - targetCpa: New target CPA in dollars - targetRoas: New target ROAS Returns: The updated campaign.

Pause a campaign. Args: - customerId: The customer ID - campaignId: The campaign ID Returns: The paused campaign.

Enable (unpause) a campaign. Args: - customerId: The customer ID - campaignId: The campaign ID Returns: The enabled campaign.

Remove (delete) a campaign. Args: - customerId: The customer ID - campaignId: The campaign ID Returns: Confirmation of removal.

List conversion actions for a Google Ads customer account. Conversion actions track valuable customer activities like purchases, sign-ups, phone calls, and app installs. Args: - customerId: The customer ID - pageSize: Number of conversions to return (1-100, default: 50) - pageToken: Pagination token from previous response - format: Response format ('json' or 'markdown') Returns: Paginated list of conversion actions with type, category, and status.

Get details for a specific conversion action. Args: - customerId: The customer ID - conversionActionId: The conversion action ID - format: Response format Returns: Conversion action details including type, category, value settings, and attribution model.

List all Google Ads customer accounts accessible with the current credentials. Returns a list of customer resource names that can be managed with the provided credentials. These are the accounts you can operate on. Returns: List of customer resource names (e.g., "customers/1234567890")

Get details for a specific Google Ads customer account. Args: - customerId: The customer ID (without dashes) - format: Response format ('json' or 'markdown') Returns: Customer details including name, currency, timezone, and status.

List keywords for a Google Ads customer account. Args: - customerId: The customer ID - adGroupId: Filter by ad group ID (optional) - pageSize: Number of keywords to return (1-100, default: 50) - pageToken: Pagination token from previous response - format: Response format ('json' or 'markdown') Returns: Paginated list of keywords with match type, status, bid, and quality score.

Get details for a specific keyword. Args: - customerId: The customer ID - adGroupId: The ad group ID - criterionId: The keyword criterion ID - format: Response format Returns: Keyword details including text, match type, status, bid, and quality info.

Add a keyword to an ad group. Args: - customerId: The customer ID - adGroupResourceName: Resource name of the ad group - text: Keyword text - matchType: Match type (EXACT, PHRASE, BROAD) - status: Initial status (ENABLED, PAUSED) - defaults to ENABLED - cpcBidDollars: CPC bid in dollars (optional) Returns: The created keyword.

Execute a GAQL (Google Ads Query Language) query for custom reporting. GAQL allows you to query any Google Ads data including campaigns, ad groups, ads, keywords, and their performance metrics. Example queries: - Campaign performance: SELECT campaign.name, metrics.impressions, metrics.clicks, metrics.cost_micros FROM campaign WHERE segments.date DURING LAST_30_DAYS - Keyword performance: SELECT ad_group_criterion.keyword.text, metrics.impressions, metrics.conversions FROM keyword_view WHERE campaign.id = 123456 - Ad group daily metrics: SELECT ad_group.name, segments.date, metrics.clicks FROM ad_group WHERE segments.date DURING LAST_7_DAYS Args: - customerId: The customer ID - query: GAQL query string - pageSize: Number of results per page (1-10000, default: 1000) - pageToken: Pagination token from previous response - format: Response format ('json' or 'markdown') Returns: Query results with requested fields and metrics.

Execute a GAQL query using streaming for large result sets. Use this for queries that may return more than 10,000 rows. The streaming endpoint returns all results without pagination. Args: - customerId: The customer ID - query: GAQL query string - format: Response format ('json' or 'markdown') Returns: All query results (may be large).

Get campaign performance metrics for a date range. A convenience method that runs a pre-built GAQL query for campaign performance. Args: - customerId: The customer ID - dateRange: Date range (LAST_7_DAYS, LAST_30_DAYS, LAST_90_DAYS, THIS_MONTH, LAST_MONTH) - campaignIds: Filter by specific campaign IDs (optional) - includeRemoved: Include removed campaigns (default: false) - format: Response format Returns: Campaign performance data with impressions, clicks, cost, and conversions.

Get ad group performance metrics for a date range. Args: - customerId: The customer ID - dateRange: Date range - campaignId: Filter by campaign ID (optional) - format: Response format Returns: Ad group performance data with impressions, clicks, cost, and conversions.

Get keyword performance metrics for a date range. Args: - customerId: The customer ID - dateRange: Date range - adGroupId: Filter by ad group ID (optional) - campaignId: Filter by campaign ID (optional) - format: Response format Returns: Keyword performance data with impressions, clicks, cost, quality score, and conversions.

Get search terms report showing actual search queries that triggered ads. Args: - customerId: The customer ID - dateRange: Date range - campaignId: Filter by campaign ID (optional) - format: Response format Returns: Search terms with performance metrics.

Get performance metrics by geographic location. Args: - customerId: The customer ID - dateRange: Date range - campaignId: Filter by campaign ID (optional) - format: Response format Returns: Performance data segmented by country and region.

Get performance metrics by device type. Args: - customerId: The customer ID - dateRange: Date range - campaignId: Filter by campaign ID (optional) - format: Response format Returns: Performance data segmented by device (mobile, desktop, tablet).