mcp-google-ads 1.4.2 → 1.5.0

package/dist/adGroupBuilder.d.ts

@@ -2,13 +2,14 @@
  * Pure builder for ad-group creation payloads. Separate from the manager so
  * it can be unit-tested without stubbing the live API.
  *
- * `type` for DEMAND_GEN_MULTI_ASSET_AD_GROUP emits the raw proto value 21
- * because the google-ads-api v23 enum map does not include it; the typed
- * AdGroup create path validates against the local enum, so DG creation must
- * flow through customer.mutateResources (which trusts the numeric value).
+ * DEMAND_GEN_MULTI_ASSET_AD_GROUP uses the string enum name rather than the
+ * integer 21. The v23 library's local enum map does not include 21, so integer
+ * 21 gets JSON-serialized as "UNKNOWN_ENUM_VALUE_AdGroupType_21" which the API
+ * rejects. Passing the string name directly bypasses the local enum lookup.
+ * DG creation still flows through customer.mutateResources to avoid the typed
+ * AdGroup.create path which only accepts known client-side enum values.
  */
 export type AdGroupTypeName = "SEARCH_STANDARD" | "DEMAND_GEN_MULTI_ASSET_AD_GROUP";
-export declare const AD_GROUP_TYPE_DEMAND_GEN_MULTI_ASSET = 21;
 export interface AdGroupCreateInput {
     customer_id_clean: string;
     name: string;
@@ -21,6 +22,6 @@ export interface AdGroupCreatePayload {
     campaign: string;
     status: number;
     cpc_bid_micros: number;
-    type: number;
+    type: number | string;
 }
 export declare function buildAdGroupCreatePayload(input: AdGroupCreateInput): AdGroupCreatePayload;

package/dist/adGroupBuilder.js

@@ -1,7 +1,6 @@
 import { enums } from "google-ads-api";
-const AD_GROUP_TYPE_DEMAND_GEN_MULTI_ASSET = 21;
 function buildAdGroupCreatePayload(input) {
-  const typeEnum = input.type === "DEMAND_GEN_MULTI_ASSET_AD_GROUP" ? AD_GROUP_TYPE_DEMAND_GEN_MULTI_ASSET : enums.AdGroupType.SEARCH_STANDARD;
+  const typeEnum = input.type === "DEMAND_GEN_MULTI_ASSET_AD_GROUP" ? "DEMAND_GEN_MULTI_ASSET_AD_GROUP" : enums.AdGroupType.SEARCH_STANDARD;
   return {
     name: input.name,
     campaign: `customers/${input.customer_id_clean}/campaigns/${input.campaign_id}`,
@@ -11,7 +10,6 @@ function buildAdGroupCreatePayload(input) {
   };
 }
 export {
-  AD_GROUP_TYPE_DEMAND_GEN_MULTI_ASSET,
   buildAdGroupCreatePayload
 };
 //# sourceMappingURL=adGroupBuilder.js.map

package/dist/assetHelpers.d.ts

@@ -52,4 +52,47 @@ export interface PauseLinksDryRun {
         ad_group_asset: string[];
     };
 }
+export interface CreateSitelinkArgs {
+    customer_id?: string;
+    link_text: string;
+    final_urls: string[];
+    description1?: string;
+    description2?: string;
+    confirm?: boolean;
+}
+export interface CreateSitelinkDryRun {
+    dry_run: true;
+    message: string;
+    customer_id: string;
+    link_text: string;
+    final_urls: string[];
+    description1?: string;
+    description2?: string;
+}
+export declare function normalizeCreateSitelinkArgs(raw: Record<string, unknown> | undefined): CreateSitelinkArgs | {
+    error: string;
+};
+export declare function buildCreateSitelinkDryRun(args: CreateSitelinkArgs): CreateSitelinkDryRun;
+export interface ReplaceSitelinkArgs {
+    customer_id?: string;
+    old_asset_id: string;
+    new_final_urls: string[];
+    new_link_text?: string;
+    new_description1?: string;
+    new_description2?: string;
+    confirm?: boolean;
+}
+export interface ReplaceSitelinkDryRun {
+    dry_run: true;
+    message: string;
+    customer_id: string;
+    old_asset_id: string;
+    new_final_urls: string[];
+    new_link_text_override?: string;
+    warning: string;
+}
+export declare function normalizeReplaceSitelinkArgs(raw: Record<string, unknown> | undefined): ReplaceSitelinkArgs | {
+    error: string;
+};
+export declare function buildReplaceSitelinkDryRun(args: ReplaceSitelinkArgs): ReplaceSitelinkDryRun;
 export declare function buildPauseLinksDryRun(args: PauseAssetLinksArgs): PauseLinksDryRun;

package/dist/assetHelpers.js

@@ -99,6 +99,95 @@ function buildUpdateUrlsDryRun(args) {
     warning: "Updating an asset's final_urls affects EVERY campaign/ad group/customer link that uses this asset ID. Verify attachments before confirming."
   };
 }
+function validateSitelinkText(value, field, max) {
+  if (typeof value !== "string") return { ok: false, error: `${field} must be a string` };
+  const t = value.trim();
+  if (!t) return { ok: false, error: `${field} must be non-empty` };
+  if (t.length > max) return { ok: false, error: `${field} exceeds ${max} chars (got ${t.length})` };
+  return { ok: true, value: t };
+}
+function normalizeCreateSitelinkArgs(raw) {
+  const r = raw ?? {};
+  const customer_id = typeof r.customer_id === "string" ? r.customer_id : void 0;
+  const linkText = validateSitelinkText(r.link_text, "link_text", 25);
+  if (!linkText.ok) return { error: linkText.error };
+  const urls = validateFinalUrls(r.final_urls);
+  if (!urls.ok) return { error: urls.error };
+  const out = {
+    customer_id,
+    link_text: linkText.value,
+    final_urls: urls.urls,
+    confirm: r.confirm === true || r.confirm === "true"
+  };
+  if (r.description1 !== void 0 && r.description1 !== null && r.description1 !== "") {
+    const d = validateSitelinkText(r.description1, "description1", 35);
+    if (!d.ok) return { error: d.error };
+    out.description1 = d.value;
+  }
+  if (r.description2 !== void 0 && r.description2 !== null && r.description2 !== "") {
+    const d = validateSitelinkText(r.description2, "description2", 35);
+    if (!d.ok) return { error: d.error };
+    out.description2 = d.value;
+  }
+  if (out.description1 && !out.description2 || !out.description1 && out.description2) {
+    return { error: "description1 and description2 must both be set or both omitted" };
+  }
+  return out;
+}
+function buildCreateSitelinkDryRun(args) {
+  return {
+    dry_run: true,
+    message: "DRY RUN. Nothing created. Pass confirm: true to actually create the sitelink asset.",
+    customer_id: args.customer_id ?? "",
+    link_text: args.link_text,
+    final_urls: args.final_urls,
+    description1: args.description1,
+    description2: args.description2
+  };
+}
+function normalizeReplaceSitelinkArgs(raw) {
+  const r = raw ?? {};
+  const customer_id = typeof r.customer_id === "string" ? r.customer_id : void 0;
+  const assetIdRaw = typeof r.old_asset_id === "string" ? r.old_asset_id.trim() : typeof r.old_asset_id === "number" ? String(r.old_asset_id) : "";
+  if (!assetIdRaw || !/^\d+$/.test(assetIdRaw)) {
+    return { error: `invalid old_asset_id: ${JSON.stringify(r.old_asset_id)}. Expected numeric asset ID.` };
+  }
+  const urls = validateFinalUrls(r.new_final_urls);
+  if (!urls.ok) return { error: urls.error };
+  const out = {
+    customer_id,
+    old_asset_id: assetIdRaw,
+    new_final_urls: urls.urls,
+    confirm: r.confirm === true || r.confirm === "true"
+  };
+  if (r.new_link_text !== void 0 && r.new_link_text !== null && r.new_link_text !== "") {
+    const d = validateSitelinkText(r.new_link_text, "new_link_text", 25);
+    if (!d.ok) return { error: d.error };
+    out.new_link_text = d.value;
+  }
+  if (r.new_description1 !== void 0 && r.new_description1 !== null && r.new_description1 !== "") {
+    const d = validateSitelinkText(r.new_description1, "new_description1", 35);
+    if (!d.ok) return { error: d.error };
+    out.new_description1 = d.value;
+  }
+  if (r.new_description2 !== void 0 && r.new_description2 !== null && r.new_description2 !== "") {
+    const d = validateSitelinkText(r.new_description2, "new_description2", 35);
+    if (!d.ok) return { error: d.error };
+    out.new_description2 = d.value;
+  }
+  return out;
+}
+function buildReplaceSitelinkDryRun(args) {
+  return {
+    dry_run: true,
+    message: "DRY RUN. Nothing changed. Pass confirm: true to replace the sitelink.",
+    customer_id: args.customer_id ?? "",
+    old_asset_id: args.old_asset_id,
+    new_final_urls: args.new_final_urls,
+    new_link_text_override: args.new_link_text,
+    warning: "Will create a NEW sitelink asset, re-link every campaign/ad-group/customer link currently pointing at old_asset_id, then remove the old links. The old Asset itself is NOT deleted and can still be re-used manually."
+  };
+}
 function buildPauseLinksDryRun(args) {
   const would = {
     customer_asset: [],
@@ -119,9 +208,13 @@ function buildPauseLinksDryRun(args) {
   };
 }
 export {
+  buildCreateSitelinkDryRun,
   buildPauseLinksDryRun,
+  buildReplaceSitelinkDryRun,
   buildUpdateUrlsDryRun,
+  normalizeCreateSitelinkArgs,
   normalizePauseAssetLinksArgs,
+  normalizeReplaceSitelinkArgs,
   normalizeUpdateAssetUrlsArgs,
   parseAssetLinkResourceName,
   validateFinalUrls

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "sha": "baabc65",
-  "builtAt": "2026-04-18T17:46:42.713Z",
+  "sha": "cc6cf6c",
+  "builtAt": "2026-04-27T14:57:08.443Z",
   "embeddedSecrets": true
 }

package/dist/campaignBuilder.js

@@ -17,15 +17,21 @@ function buildCampaignCreatePayload(input) {
   const campaign = {
     name: input.name,
     status: enums.CampaignStatus.PAUSED,
-    advertising_channel_type: channelEnum
+    advertising_channel_type: channelEnum,
+    // EuPoliticalAdvertisingStatus enum: 3 = DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
+    // Required for all new campaigns in API v23+. Must be a non-zero enum value
+    // (proto3 strips default/zero values, so `false`/0 gets omitted and the API
+    // rejects with "required field not present").
+    contains_eu_political_advertising: enums.EuPoliticalAdvertisingStatus?.DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING ?? 3
   };
   if (channelType === "DEMAND_GEN") {
     campaign.network_settings = {
-      target_google_search: false,
+      target_google_search: true,
       target_search_network: false,
-      target_content_network: true,
+      target_content_network: false,
       target_partner_search_network: false
     };
+    campaign.audience_setting = { use_audience_grouped: true };
   }
   if (input.start_date) campaign.start_date = input.start_date;
   if (input.end_date) campaign.end_date = input.end_date;

package/dist/experimentBuilder.d.ts

@@ -0,0 +1,36 @@
+export interface ExperimentCreateInput {
+    base_campaign_id: string;
+    name: string;
+    description?: string;
+    /** Suffix appended to the auto-created treatment campaign name. Defaults to " [EXP]" */
+    suffix?: string;
+    /** Percent of traffic sent to treatment arm (1–99). Defaults to 50. */
+    traffic_split_percent?: number;
+    start_date?: string;
+    end_date?: string;
+}
+export interface ExperimentArmPayload {
+    experiment: string;
+    name: string;
+    control: boolean;
+    traffic_split: number;
+    campaigns: string[];
+}
+export interface ExperimentPayload {
+    name: string;
+    description?: string;
+    suffix: string;
+    type: number;
+    status: number;
+    start_date?: string;
+    end_date?: string;
+}
+export declare function buildExperimentPayload(input: ExperimentCreateInput): ExperimentPayload;
+export declare function buildControlArmPayload(experimentResourceName: string, baseCampaignResourceName: string, trafficSplit: number): ExperimentArmPayload;
+export declare function buildTreatmentArmPayload(experimentResourceName: string, trafficSplit: number): ExperimentArmPayload;
+/** Format YYYY-MM-DD from a Date (or today). */
+export declare function formatDate(d?: Date): string;
+/** Parse an experiment resource name and return the numeric experiment id. */
+export declare function experimentIdFromResourceName(resourceName: string): string;
+/** Parse a campaign resource name and return the numeric campaign id. */
+export declare function campaignIdFromResourceName(resourceName: string): string;

package/dist/experimentBuilder.js

@@ -0,0 +1,52 @@
+import { enums } from "google-ads-api";
+function buildExperimentPayload(input) {
+  return {
+    name: input.name,
+    ...input.description ? { description: input.description } : {},
+    suffix: input.suffix ?? " [EXP]",
+    type: enums.ExperimentType.SEARCH_CUSTOM,
+    // 7
+    status: enums.ExperimentStatus.SETUP,
+    // 6
+    ...input.start_date ? { start_date: input.start_date } : {},
+    ...input.end_date ? { end_date: input.end_date } : {}
+  };
+}
+function buildControlArmPayload(experimentResourceName, baseCampaignResourceName, trafficSplit) {
+  return {
+    experiment: experimentResourceName,
+    name: "Control",
+    control: true,
+    traffic_split: trafficSplit,
+    campaigns: [baseCampaignResourceName]
+  };
+}
+function buildTreatmentArmPayload(experimentResourceName, trafficSplit) {
+  return {
+    experiment: experimentResourceName,
+    name: "Treatment",
+    control: false,
+    traffic_split: trafficSplit,
+    campaigns: []
+    // Google auto-creates a copy of the base campaign
+  };
+}
+function formatDate(d) {
+  const dt = d ?? /* @__PURE__ */ new Date();
+  return dt.toISOString().slice(0, 10);
+}
+function experimentIdFromResourceName(resourceName) {
+  return resourceName.split("/").pop() ?? "";
+}
+function campaignIdFromResourceName(resourceName) {
+  return resourceName.split("/").pop() ?? "";
+}
+export {
+  buildControlArmPayload,
+  buildExperimentPayload,
+  buildTreatmentArmPayload,
+  campaignIdFromResourceName,
+  experimentIdFromResourceName,
+  formatDate
+};
+//# sourceMappingURL=experimentBuilder.js.map