mcp-google-ads 1.0.0

package/dist/resilience.d.ts

@@ -0,0 +1,3 @@
+export declare const logger: import("pino").Logger<never>;
+export declare function safeResponse<T>(data: T, context: string): T;
+export declare function withResilience<T>(fn: () => Promise<T>, operationName: string): Promise<T>;

package/dist/resilience.js

@@ -0,0 +1,99 @@
+import { retry, circuitBreaker, wrap, handleAll, timeout, TimeoutStrategy, ExponentialBackoff, ConsecutiveBreaker, } from "cockatiel";
+import pino from "pino";
+// ============================================
+// LOGGER
+// ============================================
+export const logger = pino({
+    level: process.env.LOG_LEVEL || "info",
+    ...(process.env.NODE_ENV !== "test" && {
+        transport: {
+            target: "pino-pretty",
+            options: {
+                colorize: true,
+                singleLine: true,
+                translateTime: "SYS:standard",
+            },
+        },
+    }),
+});
+// ============================================
+// SAFE RESPONSE (Response Size Limiting)
+// ============================================
+const MAX_RESPONSE_SIZE = 200_000; // 200KB
+export function safeResponse(data, context) {
+    const jsonStr = JSON.stringify(data);
+    const sizeBytes = Buffer.byteLength(jsonStr, "utf-8");
+    if (sizeBytes > MAX_RESPONSE_SIZE) {
+        logger.warn({ sizeBytes, maxSize: MAX_RESPONSE_SIZE, context }, `Response exceeds size limit, truncating`);
+        // If it's an array, truncate
+        if (Array.isArray(data)) {
+            const truncated = data.slice(0, Math.max(1, Math.floor(data.length * 0.5)));
+            return truncated;
+        }
+        // If it's an object with items/results, truncate those
+        if (typeof data === "object" && data !== null) {
+            const obj = data;
+            for (const key of ["items", "results", "data", "rows"]) {
+                if (Array.isArray(obj[key])) {
+                    obj[key] = obj[key].slice(0, Math.max(1, Math.floor(obj[key].length * 0.5)));
+                    return obj;
+                }
+            }
+        }
+    }
+    return data;
+}
+// ============================================
+// RETRY + CIRCUIT BREAKER + TIMEOUT
+// ============================================
+const backoff = new ExponentialBackoff({
+    initialDelay: 100,
+    maxDelay: 5_000,
+});
+// Individual policies
+const retryPolicy = retry(handleAll, {
+    maxAttempts: 3,
+    backoff,
+});
+const circuitBreakerPolicy = circuitBreaker(handleAll, {
+    halfOpenAfter: 60_000, // 60s to attempt recovery
+    breaker: new ConsecutiveBreaker(5), // Open after 5 consecutive failures
+});
+const timeoutPolicy = timeout(30_000, TimeoutStrategy.Cooperative);
+// Combine policies: timeout -> circuit breaker -> retry
+const policy = wrap(timeoutPolicy, circuitBreakerPolicy, retryPolicy);
+// ============================================
+// WRAPPED API CALL WITH LOGGING
+// ============================================
+export async function withResilience(fn, operationName) {
+    try {
+        logger.debug({ operation: operationName }, "Starting API call");
+        const result = await policy.execute(() => fn());
+        logger.debug({ operation: operationName }, "API call succeeded");
+        return result;
+    }
+    catch (err) {
+        // Extract a useful message from gRPC/google-ads-api errors
+        // where String(err) produces "[object Object]"
+        let error;
+        if (err instanceof Error) {
+            error = err;
+        }
+        else {
+            // Try to get message from nested errors array (google-ads-api pattern)
+            const nested = err?.errors?.[0];
+            const msg = nested?.message
+                || (typeof err?.message === "string" ? err.message : null)
+                || (() => { try {
+                    return JSON.stringify(err);
+                }
+                catch {
+                    return String(err);
+                } })();
+            error = new Error(msg);
+            error.cause = err;
+        }
+        logger.error({ operation: operationName, error: error.message, stack: error.stack }, "API call failed after retries");
+        throw error;
+    }
+}

package/dist/tools.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const tools: Tool[];

package/dist/tools.js

@@ -0,0 +1,574 @@
+export const tools = [
+    {
+        name: "google_ads_get_client_context",
+        description: "Get the current client context based on working directory. Call this first to confirm which Google Ads account you're working with.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                working_directory: {
+                    type: "string",
+                    description: "The current working directory",
+                },
+            },
+            required: ["working_directory"],
+        },
+    },
+    {
+        name: "google_ads_list_campaigns",
+        description: "List all campaigns for the current client account",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: {
+                    type: "string",
+                    description: "The customer ID (will use context if not provided)",
+                },
+            },
+        },
+    },
+    {
+        name: "google_ads_list_ad_groups",
+        description: "List ad groups, optionally filtered by campaign",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                campaign_id: { type: "string" },
+            },
+        },
+    },
+    {
+        name: "google_ads_get_campaign_tracking",
+        description: "Get campaign tracking parameters including tracking URL template, final URL suffix, and custom URL parameters",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                campaign_id: { type: "string", description: "The campaign ID to get tracking info for" },
+            },
+            required: ["campaign_id"],
+        },
+    },
+    {
+        name: "google_ads_list_pending_changes",
+        description: "List all pending changes (paused items with claude- label) awaiting review",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+            },
+        },
+    },
+    {
+        name: "google_ads_validate_ad",
+        description: "Validate an RSA without creating it. Use this to check for errors before creating.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                headlines: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "3-15 headlines, max 30 chars each",
+                },
+                descriptions: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "2-4 descriptions, max 90 chars each",
+                },
+                final_urls: {
+                    type: "array",
+                    items: { type: "string" },
+                },
+            },
+            required: ["headlines", "descriptions", "final_urls"],
+        },
+    },
+    {
+        name: "google_ads_create_campaign",
+        description: "Create a new campaign (will be PAUSED until approved). Returns campaign ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                name: { type: "string" },
+                daily_budget: { type: "number", description: "Daily budget in dollars" },
+            },
+            required: ["name", "daily_budget"],
+        },
+    },
+    {
+        name: "google_ads_create_ad_group",
+        description: "Create a new ad group (will be PAUSED until approved). Returns ad group ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                campaign_id: { type: "string" },
+                name: { type: "string" },
+                cpc_bid: { type: "number", description: "CPC bid in dollars" },
+            },
+            required: ["campaign_id", "name"],
+        },
+    },
+    {
+        name: "google_ads_create_responsive_search_ad",
+        description: "Create a responsive search ad (will be PAUSED until approved). Validates before creating. Headlines/descriptions can be plain strings or objects with pinned_position (1-3 for headlines, 1-2 for descriptions).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                ad_group_id: { type: "string" },
+                final_urls: { type: "array", items: { type: "string" } },
+                headlines: {
+                    type: "array",
+                    items: {
+                        oneOf: [
+                            { type: "string" },
+                            {
+                                type: "object",
+                                properties: {
+                                    text: { type: "string" },
+                                    pinned_position: { type: "number", description: "Pin to position 1, 2, or 3" },
+                                },
+                                required: ["text"],
+                            },
+                        ],
+                    },
+                },
+                descriptions: {
+                    type: "array",
+                    items: {
+                        oneOf: [
+                            { type: "string" },
+                            {
+                                type: "object",
+                                properties: {
+                                    text: { type: "string" },
+                                    pinned_position: { type: "number", description: "Pin to position 1 or 2" },
+                                },
+                                required: ["text"],
+                            },
+                        ],
+                    },
+                },
+                path1: { type: "string" },
+                path2: { type: "string" },
+            },
+            required: ["ad_group_id", "final_urls", "headlines", "descriptions"],
+        },
+    },
+    {
+        name: "google_ads_create_keywords",
+        description: "Create keywords for an ad group (will be PAUSED until approved). Keywords are auto-labeled for easy discovery via google_ads_list_pending_changes.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                ad_group_id: { type: "string" },
+                keywords: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            text: { type: "string" },
+                            match_type: { type: "string", enum: ["BROAD", "PHRASE", "EXACT"] },
+                        },
+                        required: ["text", "match_type"],
+                    },
+                },
+                label: {
+                    type: "string",
+                    description: "Label to apply to created keywords (default: 'claude-pending'). Use to group and find paused keywords later.",
+                },
+            },
+            required: ["ad_group_id", "keywords"],
+        },
+    },
+    {
+        name: "google_ads_enable_items",
+        description: "Enable paused campaigns, ad groups, or ads. REQUIRES USER APPROVAL. Use after reviewing in Google Ads UI.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                campaign_ids: { type: "array", items: { type: "string" } },
+                ad_group_ids: { type: "array", items: { type: "string" } },
+                ad_ids: { type: "array", items: { type: "string" } },
+            },
+        },
+    },
+    {
+        name: "google_ads_pause_items",
+        description: "Pause enabled campaigns, ad groups, or ads. REQUIRES USER APPROVAL. This will stop items from serving.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                campaign_ids: { type: "array", items: { type: "string" } },
+                ad_group_ids: { type: "array", items: { type: "string" } },
+                ad_ids: { type: "array", items: { type: "string" } },
+            },
+        },
+    },
+    {
+        name: "google_ads_create_shared_set",
+        description: "Create a new shared negative keyword list at account level. Returns the new shared set ID.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                name: { type: "string", description: "Name for the new shared negative keyword list" },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "google_ads_link_shared_set",
+        description: "Link a shared negative keyword list to one or more campaigns. Once linked, all negatives in the list will apply to those campaigns.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                shared_set_id: { type: "string", description: "The shared set ID to link" },
+                campaign_ids: { type: "array", items: { type: "string" }, description: "Campaign IDs to link the shared set to" },
+            },
+            required: ["shared_set_id", "campaign_ids"],
+        },
+    },
+    {
+        name: "google_ads_unlink_shared_set",
+        description: "Unlink a shared negative keyword list from one or more campaigns. The list's negatives will no longer apply to those campaigns.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                shared_set_id: { type: "string", description: "The shared set ID to unlink" },
+                campaign_ids: { type: "array", items: { type: "string" }, description: "Campaign IDs to unlink the shared set from" },
+            },
+            required: ["shared_set_id", "campaign_ids"],
+        },
+    },
+    {
+        name: "google_ads_add_shared_negatives",
+        description: "Add negative keywords to a shared negative keyword list. Keywords will immediately block matching queries across all campaigns the list is applied to.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                shared_set_id: { type: "string", description: "The shared set ID to add keywords to" },
+                keywords: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            text: { type: "string" },
+                            match_type: { type: "string", enum: ["BROAD", "PHRASE", "EXACT"] },
+                        },
+                        required: ["text", "match_type"],
+                    },
+                },
+            },
+            required: ["shared_set_id", "keywords"],
+        },
+    },
+    {
+        name: "google_ads_remove_shared_negatives",
+        description: "Remove negative keywords from a shared negative keyword list by their resource names. Get resource names from a GAQL query on shared_criterion.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                resource_names: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Resource names of the shared criteria to remove (e.g. customers/1234/sharedCriteria/5678~9012)",
+                },
+            },
+            required: ["resource_names"],
+        },
+    },
+    {
+        name: "google_ads_add_campaign_negatives",
+        description: "Add negative keywords at the campaign level. Use for campaign-specific negatives that shouldn't be in a shared list.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                campaign_id: { type: "string" },
+                keywords: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            text: { type: "string" },
+                            match_type: { type: "string", enum: ["BROAD", "PHRASE", "EXACT"] },
+                        },
+                        required: ["text", "match_type"],
+                    },
+                },
+            },
+            required: ["campaign_id", "keywords"],
+        },
+    },
+    {
+        name: "google_ads_remove_campaign_negatives",
+        description: "Remove campaign-level negative keywords by their resource names. Get resource names from a GAQL query on campaign_criterion.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                resource_names: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Resource names of the campaign criteria to remove (e.g. customers/1234/campaignCriteria/5678~9012)",
+                },
+            },
+            required: ["resource_names"],
+        },
+    },
+    {
+        name: "google_ads_remove_adgroup_negatives",
+        description: "Remove ad-group-level negative keywords by their resource names. Get resource names from a GAQL query on ad_group_criterion.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                resource_names: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Resource names of the ad group criteria to remove (e.g. customers/1234/adGroupCriteria/5678~9012)",
+                },
+            },
+            required: ["resource_names"],
+        },
+    },
+    {
+        name: "google_ads_pause_keywords",
+        description: "Pause active keywords by their criterion resource names.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                criterion_resource_names: { type: "array", items: { type: "string" }, description: "Full resource names like customers/123/adGroupCriteria/456~789" },
+            },
+            required: ["criterion_resource_names"],
+        },
+    },
+    {
+        name: "google_ads_update_campaign_tracking",
+        description: "Update campaign tracking parameters: final URL suffix, tracking URL template, and/or custom URL parameters. Use google_ads_get_campaign_tracking first to see current values.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                campaign_id: { type: "string", description: "The campaign ID to update" },
+                final_url_suffix: { type: "string", description: "New final URL suffix (appended to landing page URLs). Set to empty string to clear." },
+                tracking_url_template: { type: "string", description: "New tracking URL template. Set to empty string to clear." },
+                url_custom_parameters: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            key: { type: "string", description: "Parameter name (without {_ } wrapper)" },
+                            value: { type: "string", description: "Parameter value (can include ValueTrack macros)" },
+                        },
+                        required: ["key", "value"],
+                    },
+                    description: "Custom URL parameters (replaces all existing custom params)",
+                },
+            },
+            required: ["campaign_id"],
+        },
+    },
+    // ============================================
+    // REPORTING TOOLS
+    // ============================================
+    {
+        name: "google_ads_keyword_performance",
+        description: "Get keyword performance report with metrics including impressions, clicks, cost, conversions, quality score components (quality score, expected CTR, ad relevance, landing page experience), and impression share metrics.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                start_date: { type: "string", description: "Start date in YYYY-MM-DD format" },
+                end_date: { type: "string", description: "End date in YYYY-MM-DD format" },
+                keyword_text_contains: { type: "string", description: "Filter keywords containing this text" },
+                campaign_ids: { type: "array", items: { type: "string" }, description: "Filter by campaign IDs" },
+                ad_group_ids: { type: "array", items: { type: "string" }, description: "Filter by ad group IDs" },
+            },
+            required: ["start_date", "end_date"],
+        },
+    },
+    {
+        name: "google_ads_keyword_performance_by_conversion",
+        description: "Get keyword performance broken down by conversion action. Shows which keywords drive which conversion types (e.g., form fills, MQLs, etc.).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                start_date: { type: "string", description: "Start date in YYYY-MM-DD format" },
+                end_date: { type: "string", description: "End date in YYYY-MM-DD format" },
+                keyword_text_contains: { type: "string", description: "Filter keywords containing this text" },
+                campaign_ids: { type: "array", items: { type: "string" }, description: "Filter by campaign IDs" },
+                ad_group_ids: { type: "array", items: { type: "string" }, description: "Filter by ad group IDs" },
+            },
+            required: ["start_date", "end_date"],
+        },
+    },
+    {
+        name: "google_ads_search_term_report",
+        description: "Get search term report showing actual search queries that triggered ads, with the keyword they matched to.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                start_date: { type: "string", description: "Start date in YYYY-MM-DD format" },
+                end_date: { type: "string", description: "End date in YYYY-MM-DD format" },
+                keyword_text_contains: { type: "string", description: "Filter by keyword text" },
+                search_term_contains: { type: "string", description: "Filter search terms containing this text" },
+                campaign_ids: { type: "array", items: { type: "string" }, description: "Filter by campaign IDs" },
+                ad_group_ids: { type: "array", items: { type: "string" }, description: "Filter by ad group IDs" },
+            },
+            required: ["start_date", "end_date"],
+        },
+    },
+    {
+        name: "google_ads_search_term_report_by_conversion",
+        description: "Get search term report broken down by conversion action. Shows which search queries drive which conversion types.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                start_date: { type: "string", description: "Start date in YYYY-MM-DD format" },
+                end_date: { type: "string", description: "End date in YYYY-MM-DD format" },
+                keyword_text_contains: { type: "string", description: "Filter by keyword text" },
+                search_term_contains: { type: "string", description: "Filter search terms containing this text" },
+                campaign_ids: { type: "array", items: { type: "string" }, description: "Filter by campaign IDs" },
+                ad_group_ids: { type: "array", items: { type: "string" }, description: "Filter by ad group IDs" },
+            },
+            required: ["start_date", "end_date"],
+        },
+    },
+    {
+        name: "google_ads_ad_performance",
+        description: "Get ad performance report with metrics, ad copy (headlines/descriptions), final URLs, and ad strength rating.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                start_date: { type: "string", description: "Start date in YYYY-MM-DD format" },
+                end_date: { type: "string", description: "End date in YYYY-MM-DD format" },
+                campaign_ids: { type: "array", items: { type: "string" }, description: "Filter by campaign IDs" },
+                ad_group_ids: { type: "array", items: { type: "string" }, description: "Filter by ad group IDs" },
+            },
+            required: ["start_date", "end_date"],
+        },
+    },
+    {
+        name: "google_ads_ad_performance_by_conversion",
+        description: "Get ad performance broken down by conversion action. Shows which ads drive which conversion types.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                start_date: { type: "string", description: "Start date in YYYY-MM-DD format" },
+                end_date: { type: "string", description: "End date in YYYY-MM-DD format" },
+                campaign_ids: { type: "array", items: { type: "string" }, description: "Filter by campaign IDs" },
+                ad_group_ids: { type: "array", items: { type: "string" }, description: "Filter by ad group IDs" },
+            },
+            required: ["start_date", "end_date"],
+        },
+    },
+    {
+        name: "google_ads_list_conversion_actions",
+        description: "List all available conversion actions (e.g., form fills, MQLs, etc.) to understand what conversion tracking is set up.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+            },
+        },
+    },
+    {
+        name: "google_ads_search_term_insights",
+        description: "Get search term category insights for a campaign. Shows the search categories your ads appeared against (like the Insights panel in the Google Ads UI). Must query one campaign at a time. Optionally compares two date ranges to show trends.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                campaign_id: { type: "string", description: "The campaign ID to get insights for (required, one campaign at a time)" },
+                start_date: { type: "string", description: "Start date in YYYY-MM-DD format" },
+                end_date: { type: "string", description: "End date in YYYY-MM-DD format" },
+                compare_start_date: { type: "string", description: "Comparison period start date (optional, for trend calculation)" },
+                compare_end_date: { type: "string", description: "Comparison period end date (optional, for trend calculation)" },
+            },
+            required: ["campaign_id", "start_date", "end_date"],
+        },
+    },
+    {
+        name: "google_ads_search_term_insight_terms",
+        description: "Drill into a specific search term category to see the individual search terms within it. Requires an insight_id from google_ads_search_term_insights.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                campaign_id: { type: "string", description: "The campaign ID" },
+                insight_id: { type: "string", description: "The insight category ID from google_ads_search_term_insights results" },
+                start_date: { type: "string", description: "Start date in YYYY-MM-DD format" },
+                end_date: { type: "string", description: "End date in YYYY-MM-DD format" },
+            },
+            required: ["campaign_id", "insight_id", "start_date", "end_date"],
+        },
+    },
+    {
+        name: "google_ads_update_campaign_budget",
+        description: "Update the daily budget for a campaign. Can update the existing budget amount or create a new solo budget and reassign the campaign to it (useful for breaking shared budgets).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                campaign_id: { type: "string", description: "The campaign ID to update" },
+                daily_budget: { type: "number", description: "New daily budget in dollars" },
+                create_new_budget: { type: "boolean", description: "If true, creates a new budget and reassigns this campaign to it (breaks shared budgets). If false, updates the existing budget amount in place (affects all campaigns sharing it)." },
+            },
+            required: ["campaign_id", "daily_budget"],
+        },
+    },
+    {
+        name: "google_ads_gaql_query",
+        description: "Execute a raw GAQL (Google Ads Query Language) query. Use this for custom reports or accessing any Google Ads API resource not covered by other tools. See https://developers.google.com/google-ads/api/docs/query/overview for GAQL syntax.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string" },
+                query: { type: "string", description: "The GAQL query to execute" },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "google_ads_keyword_volume",
+        description: "Get historical search volume estimates for a list of keywords using the Google Ads Keyword Planner. Returns avg monthly searches, competition level, and CPC bid range for each keyword.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_id: { type: "string", description: "The Google Ads customer ID" },
+                keywords: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "List of keywords to get volume estimates for (max 20 per call)",
+                },
+                geo_target_constants: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Geo target resource names, e.g. ['geoTargetConstants/2840'] for US. Defaults to US if omitted.",
+                },
+                language: {
+                    type: "string",
+                    description: "Language resource name, e.g. 'languageConstants/1000' for English. Defaults to English if omitted.",
+                },
+            },
+            required: ["keywords"],
+        },
+    },
+];