@defoai/ads-client 1.4.0 → 1.4.1

package/dist/index.d.cts

@@ -0,0 +1,2226 @@
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Bind an asset to an ad (scope=AD, adId required) or ad group (scope=AD_GROUP, adGroupId required). campaignId is derived from the ad/ad group when omitted.
+ * @export
+ * @interface AdAssetCreate
+ */
+interface AdAssetCreate {
+    /**
+     *
+     * @type {string}
+     * @memberof AdAssetCreate
+     */
+    scope: AdAssetCreateScopeEnum;
+    /**
+     * Required when scope=AD.
+     * @type {string}
+     * @memberof AdAssetCreate
+     */
+    adId?: string;
+    /**
+     * Required when scope=AD_GROUP.
+     * @type {string}
+     * @memberof AdAssetCreate
+     */
+    adGroupId?: string;
+    /**
+     * Optional; derived from the ad/ad group when omitted.
+     * @type {string}
+     * @memberof AdAssetCreate
+     */
+    campaignId?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdAssetCreate
+     */
+    assetId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdAssetCreate
+     */
+    role: AdAssetCreateRoleEnum;
+}
+/**
+ * @export
+ */
+declare const AdAssetCreateScopeEnum: {
+    readonly AD: "AD";
+    readonly AD_GROUP: "AD_GROUP";
+};
+type AdAssetCreateScopeEnum = typeof AdAssetCreateScopeEnum[keyof typeof AdAssetCreateScopeEnum];
+/**
+ * @export
+ */
+declare const AdAssetCreateRoleEnum: {
+    readonly MARKETING_IMAGE: "MARKETING_IMAGE";
+    readonly SQUARE_MARKETING_IMAGE: "SQUARE_MARKETING_IMAGE";
+    readonly PORTRAIT_MARKETING_IMAGE: "PORTRAIT_MARKETING_IMAGE";
+    readonly LOGO: "LOGO";
+    readonly LANDSCAPE_LOGO: "LANDSCAPE_LOGO";
+    readonly YOUTUBE_VIDEO: "YOUTUBE_VIDEO";
+    readonly VIDEO: "VIDEO";
+};
+type AdAssetCreateRoleEnum = typeof AdAssetCreateRoleEnum[keyof typeof AdAssetCreateRoleEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface Sitelink
+ */
+interface Sitelink {
+    /**
+     *
+     * @type {string}
+     * @memberof Sitelink
+     */
+    text?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof Sitelink
+     */
+    url?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof Sitelink
+     */
+    description1?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof Sitelink
+     */
+    description2?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof Sitelink
+     */
+    trackingUrlTemplate?: string;
+    /**
+     *
+     * @type {{ [key: string]: string; }}
+     * @memberof Sitelink
+     */
+    urlCustomParameters?: {
+        [key: string]: string;
+    };
+}
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface StructuredSnippet
+ */
+interface StructuredSnippet {
+    /**
+     *
+     * @type {string}
+     * @memberof StructuredSnippet
+     */
+    header: string;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof StructuredSnippet
+     */
+    values: Array<string>;
+}
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface AdCreate
+ */
+interface AdCreate {
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    adGroupId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    campaignId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    headlinePart1: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    headlinePart2: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    headlinePart3?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    description: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    description2?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    finalUrl: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    path1?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    path2?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    status?: AdCreateStatusEnum;
+    /**
+     *
+     * @type {Array<Sitelink>}
+     * @memberof AdCreate
+     */
+    sitelinks?: Array<Sitelink>;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof AdCreate
+     */
+    callouts?: Array<string>;
+    /**
+     *
+     * @type {Array<StructuredSnippet>}
+     * @memberof AdCreate
+     */
+    structuredSnippets?: Array<StructuredSnippet>;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof AdCreate
+     */
+    customLabels?: Array<string>;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    trackingUrlTemplate?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdCreate
+     */
+    finalUrlSuffix?: string;
+    /**
+     *
+     * @type {{ [key: string]: string; }}
+     * @memberof AdCreate
+     */
+    urlCustomParameters?: {
+        [key: string]: string;
+    };
+}
+/**
+ * @export
+ */
+declare const AdCreateStatusEnum: {
+    readonly ENABLED: "ENABLED";
+    readonly PAUSED: "PAUSED";
+    readonly REMOVED: "REMOVED";
+};
+type AdCreateStatusEnum = typeof AdCreateStatusEnum[keyof typeof AdCreateStatusEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface AdGroupAudience
+ */
+interface AdGroupAudience {
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupAudience
+     */
+    type: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupAudience
+     */
+    id: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AdGroupAudience
+     */
+    bidAdjustment?: number;
+}
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface AdGroupCreate
+ */
+interface AdGroupCreate {
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupCreate
+     */
+    campaignId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupCreate
+     */
+    name: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupCreate
+     */
+    status?: AdGroupCreateStatusEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupCreate
+     */
+    type?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AdGroupCreate
+     */
+    cpc?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AdGroupCreate
+     */
+    cpcBid?: number;
+    /**
+     *
+     * @type {Array<AdGroupAudience>}
+     * @memberof AdGroupCreate
+     */
+    audiences?: Array<AdGroupAudience>;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof AdGroupCreate
+     */
+    customLabels?: Array<string>;
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupCreate
+     */
+    trackingUrlTemplate?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupCreate
+     */
+    finalUrlSuffix?: string;
+    /**
+     *
+     * @type {{ [key: string]: string; }}
+     * @memberof AdGroupCreate
+     */
+    urlCustomParameters?: {
+        [key: string]: string;
+    };
+}
+/**
+ * @export
+ */
+declare const AdGroupCreateStatusEnum: {
+    readonly ENABLED: "ENABLED";
+    readonly PAUSED: "PAUSED";
+    readonly REMOVED: "REMOVED";
+};
+type AdGroupCreateStatusEnum = typeof AdGroupCreateStatusEnum[keyof typeof AdGroupCreateStatusEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Partial AdGroup. Omitted fields are unchanged.
+ * @export
+ * @interface AdGroupUpdate
+ */
+interface AdGroupUpdate {
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupUpdate
+     */
+    campaignId?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupUpdate
+     */
+    name?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupUpdate
+     */
+    status?: AdGroupUpdateStatusEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupUpdate
+     */
+    type?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AdGroupUpdate
+     */
+    cpc?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AdGroupUpdate
+     */
+    cpcBid?: number;
+    /**
+     *
+     * @type {Array<AdGroupAudience>}
+     * @memberof AdGroupUpdate
+     */
+    audiences?: Array<AdGroupAudience>;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof AdGroupUpdate
+     */
+    customLabels?: Array<string>;
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupUpdate
+     */
+    trackingUrlTemplate?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdGroupUpdate
+     */
+    finalUrlSuffix?: string;
+    /**
+     *
+     * @type {{ [key: string]: string; }}
+     * @memberof AdGroupUpdate
+     */
+    urlCustomParameters?: {
+        [key: string]: string;
+    };
+}
+/**
+ * @export
+ */
+declare const AdGroupUpdateStatusEnum: {
+    readonly ENABLED: "ENABLED";
+    readonly PAUSED: "PAUSED";
+    readonly REMOVED: "REMOVED";
+};
+type AdGroupUpdateStatusEnum = typeof AdGroupUpdateStatusEnum[keyof typeof AdGroupUpdateStatusEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Partial Ad. Omitted fields are unchanged.
+ * @export
+ * @interface AdUpdate
+ */
+interface AdUpdate {
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    adGroupId?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    campaignId?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    headlinePart1?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    headlinePart2?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    headlinePart3?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    description?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    description2?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    finalUrl?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    path1?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    path2?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    status?: AdUpdateStatusEnum;
+    /**
+     *
+     * @type {Array<Sitelink>}
+     * @memberof AdUpdate
+     */
+    sitelinks?: Array<Sitelink>;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof AdUpdate
+     */
+    callouts?: Array<string>;
+    /**
+     *
+     * @type {Array<StructuredSnippet>}
+     * @memberof AdUpdate
+     */
+    structuredSnippets?: Array<StructuredSnippet>;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof AdUpdate
+     */
+    customLabels?: Array<string>;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    trackingUrlTemplate?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AdUpdate
+     */
+    finalUrlSuffix?: string;
+    /**
+     *
+     * @type {{ [key: string]: string; }}
+     * @memberof AdUpdate
+     */
+    urlCustomParameters?: {
+        [key: string]: string;
+    };
+}
+/**
+ * @export
+ */
+declare const AdUpdateStatusEnum: {
+    readonly ENABLED: "ENABLED";
+    readonly PAUSED: "PAUSED";
+    readonly REMOVED: "REMOVED";
+};
+type AdUpdateStatusEnum = typeof AdUpdateStatusEnum[keyof typeof AdUpdateStatusEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * URL-by-reference asset creation. The asset is stored as a pointer to the remote URL and is marked READY immediately. Platform syncs fetch the bytes lazily.
+ * @export
+ * @interface AssetCreate
+ */
+interface AssetCreate {
+    /**
+     * Public http(s) URL.
+     * @type {string}
+     * @memberof AssetCreate
+     */
+    url: string;
+    /**
+     * Defaults to the URL filename.
+     * @type {string}
+     * @memberof AssetCreate
+     */
+    name?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AssetCreate
+     */
+    type?: AssetCreateTypeEnum;
+    /**
+     * Generic media bucket. Defaults from `type` when omitted (IMAGE for IMAGE/LOGO, VIDEO for VIDEO).
+     * @type {string}
+     * @memberof AssetCreate
+     */
+    mediaType?: AssetCreateMediaTypeEnum;
+    /**
+     * YouTube video id for VIDEO assets (no hosting/transcoding; referenced by id).
+     * @type {string}
+     * @memberof AssetCreate
+     */
+    youtubeVideoId?: string;
+    /**
+     * MIME type. Inferred from the URL when absent.
+     * @type {string}
+     * @memberof AssetCreate
+     */
+    contentType?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof AssetCreate
+     */
+    sizeBytes?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AssetCreate
+     */
+    width?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AssetCreate
+     */
+    height?: number;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof AssetCreate
+     */
+    tags?: Array<string>;
+    /**
+     *
+     * @type {string}
+     * @memberof AssetCreate
+     */
+    altText?: string;
+    /**
+     *
+     * @type {{ [key: string]: any; }}
+     * @memberof AssetCreate
+     */
+    metadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * @export
+ */
+declare const AssetCreateTypeEnum: {
+    readonly IMAGE: "IMAGE";
+    readonly LOGO: "LOGO";
+    readonly VIDEO: "VIDEO";
+};
+type AssetCreateTypeEnum = typeof AssetCreateTypeEnum[keyof typeof AssetCreateTypeEnum];
+/**
+ * @export
+ */
+declare const AssetCreateMediaTypeEnum: {
+    readonly IMAGE: "IMAGE";
+    readonly VIDEO: "VIDEO";
+};
+type AssetCreateMediaTypeEnum = typeof AssetCreateMediaTypeEnum[keyof typeof AssetCreateMediaTypeEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Partial Asset. Only the curated fields below are accepted; identity fields (id, url, contentType, sizeBytes, source) are immutable post-creation.
+ * @export
+ * @interface AssetUpdate
+ */
+interface AssetUpdate {
+    /**
+     *
+     * @type {string}
+     * @memberof AssetUpdate
+     */
+    name?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AssetUpdate
+     */
+    altText?: string;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof AssetUpdate
+     */
+    tags?: Array<string>;
+    /**
+     *
+     * @type {{ [key: string]: any; }}
+     * @memberof AssetUpdate
+     */
+    metadata?: {
+        [key: string]: any;
+    };
+    /**
+     *
+     * @type {string}
+     * @memberof AssetUpdate
+     */
+    status?: AssetUpdateStatusEnum;
+    /**
+     *
+     * @type {number}
+     * @memberof AssetUpdate
+     */
+    width?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof AssetUpdate
+     */
+    height?: number;
+}
+/**
+ * @export
+ */
+declare const AssetUpdateStatusEnum: {
+    readonly PROCESSING: "PROCESSING";
+    readonly READY: "READY";
+    readonly FAILED: "FAILED";
+};
+type AssetUpdateStatusEnum = typeof AssetUpdateStatusEnum[keyof typeof AssetUpdateStatusEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface BiddingStrategy
+ */
+interface BiddingStrategy {
+    /**
+     *
+     * @type {string}
+     * @memberof BiddingStrategy
+     */
+    type?: BiddingStrategyTypeEnum;
+    /**
+     *
+     * @type {number}
+     * @memberof BiddingStrategy
+     */
+    targetCpa?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof BiddingStrategy
+     */
+    targetRoas?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof BiddingStrategy
+     */
+    targetImpressionShare?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof BiddingStrategy
+     */
+    maxCpcBidCeiling?: number;
+}
+/**
+ * @export
+ */
+declare const BiddingStrategyTypeEnum: {
+    readonly MANUAL_CPC: "MANUAL_CPC";
+    readonly ENHANCED_CPC: "ENHANCED_CPC";
+    readonly MAXIMIZE_CLICKS: "MAXIMIZE_CLICKS";
+    readonly MAXIMIZE_CONVERSIONS: "MAXIMIZE_CONVERSIONS";
+    readonly MAXIMIZE_CONVERSION_VALUE: "MAXIMIZE_CONVERSION_VALUE";
+    readonly TARGET_CPA: "TARGET_CPA";
+    readonly TARGET_ROAS: "TARGET_ROAS";
+    readonly TARGET_IMPRESSION_SHARE: "TARGET_IMPRESSION_SHARE";
+};
+type BiddingStrategyTypeEnum = typeof BiddingStrategyTypeEnum[keyof typeof BiddingStrategyTypeEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface ScheduleWindow
+ */
+interface ScheduleWindow {
+    /**
+     *
+     * @type {string}
+     * @memberof ScheduleWindow
+     */
+    day: ScheduleWindowDayEnum;
+    /**
+     *
+     * @type {number}
+     * @memberof ScheduleWindow
+     */
+    startHour: number;
+    /**
+     *
+     * @type {string}
+     * @memberof ScheduleWindow
+     */
+    startMinute?: ScheduleWindowStartMinuteEnum;
+    /**
+     * 24 is the Google end-of-day sentinel and is passed through unchanged.
+     * @type {number}
+     * @memberof ScheduleWindow
+     */
+    endHour: number;
+    /**
+     *
+     * @type {string}
+     * @memberof ScheduleWindow
+     */
+    endMinute?: ScheduleWindowEndMinuteEnum;
+    /**
+     * Platform-neutral bid multiplier. 1.0 = no change. On Microsoft Ads, converted to the native -90..+900 percentage delta with clamping (a clamp emits a BID_ADJUSTMENT_CLAMPED warning).
+     * @type {number}
+     * @memberof ScheduleWindow
+     */
+    bidModifier?: number;
+}
+/**
+ * @export
+ */
+declare const ScheduleWindowDayEnum: {
+    readonly MONDAY: "MONDAY";
+    readonly TUESDAY: "TUESDAY";
+    readonly WEDNESDAY: "WEDNESDAY";
+    readonly THURSDAY: "THURSDAY";
+    readonly FRIDAY: "FRIDAY";
+    readonly SATURDAY: "SATURDAY";
+    readonly SUNDAY: "SUNDAY";
+};
+type ScheduleWindowDayEnum = typeof ScheduleWindowDayEnum[keyof typeof ScheduleWindowDayEnum];
+/**
+ * @export
+ */
+declare const ScheduleWindowStartMinuteEnum: {
+    readonly ZERO: "ZERO";
+    readonly FIFTEEN: "FIFTEEN";
+    readonly THIRTY: "THIRTY";
+    readonly FORTY_FIVE: "FORTY_FIVE";
+};
+type ScheduleWindowStartMinuteEnum = typeof ScheduleWindowStartMinuteEnum[keyof typeof ScheduleWindowStartMinuteEnum];
+/**
+ * @export
+ */
+declare const ScheduleWindowEndMinuteEnum: {
+    readonly ZERO: "ZERO";
+    readonly FIFTEEN: "FIFTEEN";
+    readonly THIRTY: "THIRTY";
+    readonly FORTY_FIVE: "FORTY_FIVE";
+};
+type ScheduleWindowEndMinuteEnum = typeof ScheduleWindowEndMinuteEnum[keyof typeof ScheduleWindowEndMinuteEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface StructuredSchedule
+ */
+interface StructuredSchedule {
+    /**
+     *
+     * @type {Array<ScheduleWindow>}
+     * @memberof StructuredSchedule
+     */
+    windows: Array<ScheduleWindow>;
+    /**
+     * IANA timezone (e.g. "Europe/Berlin"). Defaults to the account timezone if omitted.
+     * @type {string}
+     * @memberof StructuredSchedule
+     */
+    timezone?: string;
+}
+
+/**
+ * Patched by scripts/patch-generated.mjs (US-ADS-267).
+ * OpenAPI Generator emits broken codecs for oneOf schemas that mix a primitive
+ * with an object/array. The union type is correct; these identity codecs replace
+ * the broken generated ones (the values are plain JSON — no (de)serialization).
+ */
+
+type CampaignAdScheduleField = StructuredSchedule | string;
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface CampaignAssetCreate
+ */
+interface CampaignAssetCreate {
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignAssetCreate
+     */
+    campaignId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignAssetCreate
+     */
+    assetId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignAssetCreate
+     */
+    role: CampaignAssetCreateRoleEnum;
+}
+/**
+ * @export
+ */
+declare const CampaignAssetCreateRoleEnum: {
+    readonly MARKETING_IMAGE: "MARKETING_IMAGE";
+    readonly SQUARE_MARKETING_IMAGE: "SQUARE_MARKETING_IMAGE";
+    readonly PORTRAIT_MARKETING_IMAGE: "PORTRAIT_MARKETING_IMAGE";
+    readonly LOGO: "LOGO";
+    readonly LANDSCAPE_LOGO: "LANDSCAPE_LOGO";
+    readonly YOUTUBE_VIDEO: "YOUTUBE_VIDEO";
+    readonly VIDEO: "VIDEO";
+};
+type CampaignAssetCreateRoleEnum = typeof CampaignAssetCreateRoleEnum[keyof typeof CampaignAssetCreateRoleEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * US-ADS-132 structured targeting (schedule, devices, radius, LinkedIn).
+ * @export
+ * @interface CampaignTargeting
+ */
+interface CampaignTargeting {
+    /**
+     *
+     * @type {Array<object>}
+     * @memberof CampaignTargeting
+     */
+    schedule?: Array<object>;
+    /**
+     *
+     * @type {object}
+     * @memberof CampaignTargeting
+     */
+    devices?: object;
+    /**
+     *
+     * @type {object}
+     * @memberof CampaignTargeting
+     */
+    radius?: object;
+    /**
+     *
+     * @type {object}
+     * @memberof CampaignTargeting
+     */
+    linkedin?: object;
+}
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface NegativeKeywordEntry
+ */
+interface NegativeKeywordEntry {
+    /**
+     *
+     * @type {string}
+     * @memberof NegativeKeywordEntry
+     */
+    text: string;
+    /**
+     *
+     * @type {string}
+     * @memberof NegativeKeywordEntry
+     */
+    matchType: NegativeKeywordEntryMatchTypeEnum;
+}
+/**
+ * @export
+ */
+declare const NegativeKeywordEntryMatchTypeEnum: {
+    readonly EXACT: "EXACT";
+    readonly PHRASE: "PHRASE";
+    readonly BROAD: "BROAD";
+};
+type NegativeKeywordEntryMatchTypeEnum = typeof NegativeKeywordEntryMatchTypeEnum[keyof typeof NegativeKeywordEntryMatchTypeEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface Location
+ */
+interface Location {
+    /**
+     * Google Ads geo target constant ID.
+     * @type {string}
+     * @memberof Location
+     */
+    criterionId?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof Location
+     */
+    name: string;
+    /**
+     *
+     * @type {string}
+     * @memberof Location
+     */
+    type: LocationTypeEnum;
+    /**
+     * ISO country code; null for GLOBAL.
+     * @type {string}
+     * @memberof Location
+     */
+    countryCode?: string | null;
+}
+/**
+ * @export
+ */
+declare const LocationTypeEnum: {
+    readonly COUNTRY: "COUNTRY";
+    readonly CITY: "CITY";
+    readonly REGION: "REGION";
+    readonly METRO: "METRO";
+    readonly GLOBAL: "GLOBAL";
+};
+type LocationTypeEnum = typeof LocationTypeEnum[keyof typeof LocationTypeEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface CampaignCreate
+ */
+interface CampaignCreate {
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignCreate
+     */
+    name: string;
+    /**
+     *
+     * @type {number}
+     * @memberof CampaignCreate
+     */
+    budget: number;
+    /**
+     * ISO 4217 (USD, EUR, …).
+     * @type {string}
+     * @memberof CampaignCreate
+     */
+    currency?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignCreate
+     */
+    status?: CampaignCreateStatusEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignCreate
+     */
+    type?: CampaignCreateTypeEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignCreate
+     */
+    networks?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignCreate
+     */
+    languages?: string;
+    /**
+     * String ID link to a Site.
+     * @type {string}
+     * @memberof CampaignCreate
+     */
+    siteId?: string;
+    /**
+     * Free-form goal text consumed by AI.
+     * @type {string}
+     * @memberof CampaignCreate
+     */
+    goal?: string;
+    /**
+     *
+     * @type {Array<Location>}
+     * @memberof CampaignCreate
+     */
+    targetLocations?: Array<Location>;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof CampaignCreate
+     */
+    customLabels?: Array<string>;
+    /**
+     *
+     * @type {CampaignAdScheduleField}
+     * @memberof CampaignCreate
+     */
+    adSchedule?: CampaignAdScheduleField;
+    /**
+     *
+     * @type {BiddingStrategy}
+     * @memberof CampaignCreate
+     */
+    biddingStrategy?: BiddingStrategy;
+    /**
+     *
+     * @type {CampaignTargeting}
+     * @memberof CampaignCreate
+     */
+    targeting?: CampaignTargeting;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignCreate
+     */
+    trackingUrlTemplate?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignCreate
+     */
+    finalUrlSuffix?: string;
+    /**
+     *
+     * @type {{ [key: string]: string; }}
+     * @memberof CampaignCreate
+     */
+    urlCustomParameters?: {
+        [key: string]: string;
+    };
+    /**
+     *
+     * @type {Array<NegativeKeywordEntry>}
+     * @memberof CampaignCreate
+     */
+    negativeKeywords?: Array<NegativeKeywordEntry>;
+}
+/**
+ * @export
+ */
+declare const CampaignCreateStatusEnum: {
+    readonly ENABLED: "ENABLED";
+    readonly PAUSED: "PAUSED";
+    readonly REMOVED: "REMOVED";
+};
+type CampaignCreateStatusEnum = typeof CampaignCreateStatusEnum[keyof typeof CampaignCreateStatusEnum];
+/**
+ * @export
+ */
+declare const CampaignCreateTypeEnum: {
+    readonly SEARCH: "SEARCH";
+    readonly DISPLAY: "DISPLAY";
+    readonly VIDEO: "VIDEO";
+    readonly SHOPPING: "SHOPPING";
+    readonly PERFORMANCE_MAX: "PERFORMANCE_MAX";
+};
+type CampaignCreateTypeEnum = typeof CampaignCreateTypeEnum[keyof typeof CampaignCreateTypeEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Partial Campaign — any subset of CampaignCreate fields. Omitted fields are unchanged.
+ * @export
+ * @interface CampaignUpdate
+ */
+interface CampaignUpdate {
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignUpdate
+     */
+    name?: string;
+    /**
+     *
+     * @type {number}
+     * @memberof CampaignUpdate
+     */
+    budget?: number;
+    /**
+     * ISO 4217 (USD, EUR, …).
+     * @type {string}
+     * @memberof CampaignUpdate
+     */
+    currency?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignUpdate
+     */
+    status?: CampaignUpdateStatusEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignUpdate
+     */
+    type?: CampaignUpdateTypeEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignUpdate
+     */
+    networks?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignUpdate
+     */
+    languages?: string;
+    /**
+     * String ID link to a Site.
+     * @type {string}
+     * @memberof CampaignUpdate
+     */
+    siteId?: string;
+    /**
+     * Free-form goal text consumed by AI.
+     * @type {string}
+     * @memberof CampaignUpdate
+     */
+    goal?: string;
+    /**
+     *
+     * @type {Array<Location>}
+     * @memberof CampaignUpdate
+     */
+    targetLocations?: Array<Location>;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof CampaignUpdate
+     */
+    customLabels?: Array<string>;
+    /**
+     *
+     * @type {CampaignAdScheduleField}
+     * @memberof CampaignUpdate
+     */
+    adSchedule?: CampaignAdScheduleField;
+    /**
+     *
+     * @type {BiddingStrategy}
+     * @memberof CampaignUpdate
+     */
+    biddingStrategy?: BiddingStrategy;
+    /**
+     *
+     * @type {CampaignTargeting}
+     * @memberof CampaignUpdate
+     */
+    targeting?: CampaignTargeting;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignUpdate
+     */
+    trackingUrlTemplate?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof CampaignUpdate
+     */
+    finalUrlSuffix?: string;
+    /**
+     *
+     * @type {{ [key: string]: string; }}
+     * @memberof CampaignUpdate
+     */
+    urlCustomParameters?: {
+        [key: string]: string;
+    };
+    /**
+     *
+     * @type {Array<NegativeKeywordEntry>}
+     * @memberof CampaignUpdate
+     */
+    negativeKeywords?: Array<NegativeKeywordEntry>;
+}
+/**
+ * @export
+ */
+declare const CampaignUpdateStatusEnum: {
+    readonly ENABLED: "ENABLED";
+    readonly PAUSED: "PAUSED";
+    readonly REMOVED: "REMOVED";
+};
+type CampaignUpdateStatusEnum = typeof CampaignUpdateStatusEnum[keyof typeof CampaignUpdateStatusEnum];
+/**
+ * @export
+ */
+declare const CampaignUpdateTypeEnum: {
+    readonly SEARCH: "SEARCH";
+    readonly DISPLAY: "DISPLAY";
+    readonly VIDEO: "VIDEO";
+    readonly SHOPPING: "SHOPPING";
+    readonly PERFORMANCE_MAX: "PERFORMANCE_MAX";
+};
+type CampaignUpdateTypeEnum = typeof CampaignUpdateTypeEnum[keyof typeof CampaignUpdateTypeEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface KeywordCreate
+ */
+interface KeywordCreate {
+    /**
+     *
+     * @type {string}
+     * @memberof KeywordCreate
+     */
+    adGroupId: string;
+    /**
+     * Optional denormalisation.
+     * @type {string}
+     * @memberof KeywordCreate
+     */
+    campaignId?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof KeywordCreate
+     */
+    text: string;
+    /**
+     *
+     * @type {string}
+     * @memberof KeywordCreate
+     */
+    matchType?: KeywordCreateMatchTypeEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof KeywordCreate
+     */
+    status?: KeywordCreateStatusEnum;
+    /**
+     *
+     * @type {boolean}
+     * @memberof KeywordCreate
+     */
+    isNegative?: boolean;
+    /**
+     *
+     * @type {number}
+     * @memberof KeywordCreate
+     */
+    cpcBid?: number | null;
+}
+/**
+ * @export
+ */
+declare const KeywordCreateMatchTypeEnum: {
+    readonly BROAD: "BROAD";
+    readonly PHRASE: "PHRASE";
+    readonly EXACT: "EXACT";
+};
+type KeywordCreateMatchTypeEnum = typeof KeywordCreateMatchTypeEnum[keyof typeof KeywordCreateMatchTypeEnum];
+/**
+ * @export
+ */
+declare const KeywordCreateStatusEnum: {
+    readonly ENABLED: "ENABLED";
+    readonly PAUSED: "PAUSED";
+    readonly REMOVED: "REMOVED";
+};
+type KeywordCreateStatusEnum = typeof KeywordCreateStatusEnum[keyof typeof KeywordCreateStatusEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Partial Keyword. Omitted fields are unchanged.
+ * @export
+ * @interface KeywordUpdate
+ */
+interface KeywordUpdate {
+    /**
+     *
+     * @type {string}
+     * @memberof KeywordUpdate
+     */
+    adGroupId?: string;
+    /**
+     * Optional denormalisation.
+     * @type {string}
+     * @memberof KeywordUpdate
+     */
+    campaignId?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof KeywordUpdate
+     */
+    text?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof KeywordUpdate
+     */
+    matchType?: KeywordUpdateMatchTypeEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof KeywordUpdate
+     */
+    status?: KeywordUpdateStatusEnum;
+    /**
+     *
+     * @type {boolean}
+     * @memberof KeywordUpdate
+     */
+    isNegative?: boolean;
+    /**
+     *
+     * @type {number}
+     * @memberof KeywordUpdate
+     */
+    cpcBid?: number | null;
+}
+/**
+ * @export
+ */
+declare const KeywordUpdateMatchTypeEnum: {
+    readonly BROAD: "BROAD";
+    readonly PHRASE: "PHRASE";
+    readonly EXACT: "EXACT";
+};
+type KeywordUpdateMatchTypeEnum = typeof KeywordUpdateMatchTypeEnum[keyof typeof KeywordUpdateMatchTypeEnum];
+/**
+ * @export
+ */
+declare const KeywordUpdateStatusEnum: {
+    readonly ENABLED: "ENABLED";
+    readonly PAUSED: "PAUSED";
+    readonly REMOVED: "REMOVED";
+};
+type KeywordUpdateStatusEnum = typeof KeywordUpdateStatusEnum[keyof typeof KeywordUpdateStatusEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface SiteLinkEntry
+ */
+interface SiteLinkEntry {
+    /**
+     *
+     * @type {string}
+     * @memberof SiteLinkEntry
+     */
+    text?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteLinkEntry
+     */
+    url?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteLinkEntry
+     */
+    description1?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteLinkEntry
+     */
+    description2?: string;
+}
+
+/**
+ * Patched by scripts/patch-generated.mjs (US-ADS-267).
+ * OpenAPI Generator emits broken codecs for oneOf schemas that mix a primitive
+ * with an object/array. The union type is correct; these identity codecs replace
+ * the broken generated ones (the values are plain JSON — no (de)serialization).
+ */
+type SiteCreateSeoKeywords = Array<string> | string;
+
+/**
+ * Patched by scripts/patch-generated.mjs (US-ADS-267).
+ * OpenAPI Generator emits broken codecs for oneOf schemas that mix a primitive
+ * with an object/array. The union type is correct; these identity codecs replace
+ * the broken generated ones (the values are plain JSON — no (de)serialization).
+ */
+type SiteCreateTargetGroups = Array<string> | string;
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface SiteCreate
+ */
+interface SiteCreate {
+    /**
+     *
+     * @type {string}
+     * @memberof SiteCreate
+     */
+    name: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteCreate
+     */
+    url: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteCreate
+     */
+    description?: string;
+    /**
+     *
+     * @type {SiteCreateSeoKeywords}
+     * @memberof SiteCreate
+     */
+    seoKeywords?: SiteCreateSeoKeywords;
+    /**
+     *
+     * @type {SiteCreateTargetGroups}
+     * @memberof SiteCreate
+     */
+    targetGroups?: SiteCreateTargetGroups;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteCreate
+     */
+    status?: SiteCreateStatusEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteCreate
+     */
+    logoUrl?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteCreate
+     */
+    logoSource?: SiteCreateLogoSourceEnum | null;
+    /**
+     *
+     * @type {Array<SiteLinkEntry>}
+     * @memberof SiteCreate
+     */
+    siteLinks?: Array<SiteLinkEntry>;
+}
+/**
+ * @export
+ */
+declare const SiteCreateStatusEnum: {
+    readonly ENABLED: "ENABLED";
+    readonly REMOVED: "REMOVED";
+};
+type SiteCreateStatusEnum = typeof SiteCreateStatusEnum[keyof typeof SiteCreateStatusEnum];
+/**
+ * @export
+ */
+declare const SiteCreateLogoSourceEnum: {
+    readonly auto_detected: "auto-detected";
+    readonly uploaded: "uploaded";
+};
+type SiteCreateLogoSourceEnum = typeof SiteCreateLogoSourceEnum[keyof typeof SiteCreateLogoSourceEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Partial Site. Omitted fields are unchanged.
+ * @export
+ * @interface SiteUpdate
+ */
+interface SiteUpdate {
+    /**
+     *
+     * @type {string}
+     * @memberof SiteUpdate
+     */
+    name?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteUpdate
+     */
+    url?: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteUpdate
+     */
+    description?: string;
+    /**
+     *
+     * @type {SiteCreateSeoKeywords}
+     * @memberof SiteUpdate
+     */
+    seoKeywords?: SiteCreateSeoKeywords;
+    /**
+     *
+     * @type {SiteCreateTargetGroups}
+     * @memberof SiteUpdate
+     */
+    targetGroups?: SiteCreateTargetGroups;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteUpdate
+     */
+    status?: SiteUpdateStatusEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteUpdate
+     */
+    logoUrl?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof SiteUpdate
+     */
+    logoSource?: SiteUpdateLogoSourceEnum | null;
+    /**
+     *
+     * @type {Array<SiteLinkEntry>}
+     * @memberof SiteUpdate
+     */
+    siteLinks?: Array<SiteLinkEntry>;
+}
+/**
+ * @export
+ */
+declare const SiteUpdateStatusEnum: {
+    readonly ENABLED: "ENABLED";
+    readonly REMOVED: "REMOVED";
+};
+type SiteUpdateStatusEnum = typeof SiteUpdateStatusEnum[keyof typeof SiteUpdateStatusEnum];
+/**
+ * @export
+ */
+declare const SiteUpdateLogoSourceEnum: {
+    readonly auto_detected: "auto-detected";
+    readonly uploaded: "uploaded";
+};
+type SiteUpdateLogoSourceEnum = typeof SiteUpdateLogoSourceEnum[keyof typeof SiteUpdateLogoSourceEnum];
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Per-entity-type toggles + force controls.
+ * @export
+ * @interface SyncTriggerRequestOptions
+ */
+interface SyncTriggerRequestOptions {
+    /**
+     *
+     * @type {boolean}
+     * @memberof SyncTriggerRequestOptions
+     */
+    includeAdGroups?: boolean;
+    /**
+     *
+     * @type {boolean}
+     * @memberof SyncTriggerRequestOptions
+     */
+    includeKeywords?: boolean;
+    /**
+     *
+     * @type {boolean}
+     * @memberof SyncTriggerRequestOptions
+     */
+    includeAds?: boolean;
+    /**
+     * Re-export linked campaigns even when change-detection sees no change — re-runs the full tree + targeting/extensions/labels. Use to repair campaigns synced before a fix. Applies to campaigns whose remote still exists; for campaigns deleted in the ad platform, unlink then sync to recreate.
+     * @type {boolean}
+     * @memberof SyncTriggerRequestOptions
+     */
+    force?: boolean;
+    /**
+     * Restrict `force` to these campaign ids. Omit to force the whole Space.
+     * @type {Array<string>}
+     * @memberof SyncTriggerRequestOptions
+     */
+    campaignIds?: Array<string>;
+}
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * All fields optional. Omit `platforms` to sync every connected platform.
+ * @export
+ * @interface SyncTriggerRequest
+ */
+interface SyncTriggerRequest {
+    /**
+     * Platform ids to sync (e.g. ["google-ads"]). Defaults to all connected.
+     * @type {Array<string>}
+     * @memberof SyncTriggerRequest
+     */
+    platforms?: Array<string>;
+    /**
+     *
+     * @type {SyncTriggerRequestOptions}
+     * @memberof SyncTriggerRequest
+     */
+    options?: SyncTriggerRequestOptions;
+}
+
+/**
+ * Defo Ads Public API
+ * Stable public API for managing campaigns, ads, keywords, and sites.
+ *
+ * The version of the OpenAPI document: 1.4.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Clear a platform link from the active Space's campaigns, keeping the local campaigns. After unlinking, a subsequent sync re-creates them on the platform.
+ * @export
+ * @interface SyncUnlinkRequest
+ */
+interface SyncUnlinkRequest {
+    /**
+     * Platform id, e.g. "microsoft-ads".
+     * @type {string}
+     * @memberof SyncUnlinkRequest
+     */
+    platform: string;
+    /**
+     * Campaigns to unlink. Omit to unlink every campaign linked to the platform.
+     * @type {Array<string>}
+     * @memberof SyncUnlinkRequest
+     */
+    campaignIds?: Array<string>;
+    /**
+     * Also remove the campaign on the ad platform (already-removed counts as success). When false, only the local link is cleared and the remote is untouched.
+     * @type {boolean}
+     * @memberof SyncUnlinkRequest
+     */
+    deleteRemote?: boolean;
+}
+
+/** The production base URL. Override via `baseUrl` (e.g. for staging). */
+declare const PRODUCTION_BASE_URL = "https://api.ads.defoai.com";
+declare const STAGING_BASE_URL = "https://api-ads-staging.defoai.com";
+interface DefoAdsOptions {
+    /** A Defo Ads personal access token (`dads_…`). Required. */
+    token: string;
+    /** Default Space id (`spc_…`) sent as `X-Space-Id` on every call. Omit to use your Personal Space. */
+    space?: string;
+    /** Base URL. Defaults to production. Use {@link STAGING_BASE_URL} for staging. */
+    baseUrl?: string;
+    /** Max automatic retries on 429 / 5xx. Default 3. */
+    maxRetries?: number;
+    /** Inject a fetch implementation (handy for tests / non-global-fetch runtimes). */
+    fetch?: typeof fetch;
+}
+/** Base error for any non-2xx response; carries the API's `{ code, message, details }`. */
+declare class DefoAdsError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    constructor(status: number, code: string | undefined, message: string, details?: unknown);
+}
+/** 401 — missing/invalid token. */ declare class AuthError extends DefoAdsError {
+    name: string;
+}
+/** 403 — token lacks the required scope or Space membership. */ declare class ForbiddenError extends DefoAdsError {
+    name: string;
+}
+/** 404 — resource not found (or outside your Space). */ declare class NotFoundError extends DefoAdsError {
+    name: string;
+}
+/** 409 — conflict (e.g. delete blocked by dependents, or a sync already running). */ declare class ConflictError extends DefoAdsError {
+    name: string;
+}
+/** 429 — rate limited. The SDK already retried up to `maxRetries`. */ declare class RateLimitError extends DefoAdsError {
+    name: string;
+}
+interface ListParams {
+    limit?: number;
+    cursor?: string | number;
+}
+/** The Defo Ads client. Construct once, reuse everywhere. */
+declare class DefoAds {
+    readonly campaigns: {
+        /** List one page (default 50, max 200). */
+        list: (params?: ListParams) => Promise<any[]>;
+        /** Async-iterate EVERY item across all pages (follows `meta.nextCursor`). */
+        listAll(params?: ListParams): AsyncGenerator<any>;
+        /** Fetch one by id. */
+        get: (id: string) => Promise<any>;
+        /** Create. */
+        create: (body: CampaignCreate) => Promise<any>;
+        /** Partial update by id. */
+        update: (id: string, body: CampaignUpdate) => Promise<any>;
+        /** Delete by id. */
+        delete: (id: string) => Promise<any>;
+    };
+    readonly adGroups: {
+        /** List one page (default 50, max 200). */
+        list: (params?: ListParams) => Promise<any[]>;
+        /** Async-iterate EVERY item across all pages (follows `meta.nextCursor`). */
+        listAll(params?: ListParams): AsyncGenerator<any>;
+        /** Fetch one by id. */
+        get: (id: string) => Promise<any>;
+        /** Create. */
+        create: (body: AdGroupCreate) => Promise<any>;
+        /** Partial update by id. */
+        update: (id: string, body: AdGroupUpdate) => Promise<any>;
+        /** Delete by id. */
+        delete: (id: string) => Promise<any>;
+    };
+    readonly ads: {
+        /** List one page (default 50, max 200). */
+        list: (params?: ListParams) => Promise<any[]>;
+        /** Async-iterate EVERY item across all pages (follows `meta.nextCursor`). */
+        listAll(params?: ListParams): AsyncGenerator<any>;
+        /** Fetch one by id. */
+        get: (id: string) => Promise<any>;
+        /** Create. */
+        create: (body: AdCreate) => Promise<any>;
+        /** Partial update by id. */
+        update: (id: string, body: AdUpdate) => Promise<any>;
+        /** Delete by id. */
+        delete: (id: string) => Promise<any>;
+    };
+    readonly keywords: {
+        /** List one page (default 50, max 200). */
+        list: (params?: ListParams) => Promise<any[]>;
+        /** Async-iterate EVERY item across all pages (follows `meta.nextCursor`). */
+        listAll(params?: ListParams): AsyncGenerator<any>;
+        /** Fetch one by id. */
+        get: (id: string) => Promise<any>;
+        /** Create. */
+        create: (body: KeywordCreate) => Promise<any>;
+        /** Partial update by id. */
+        update: (id: string, body: KeywordUpdate) => Promise<any>;
+        /** Delete by id. */
+        delete: (id: string) => Promise<any>;
+    };
+    readonly sites: {
+        /** List one page (default 50, max 200). */
+        list: (params?: ListParams) => Promise<any[]>;
+        /** Async-iterate EVERY item across all pages (follows `meta.nextCursor`). */
+        listAll(params?: ListParams): AsyncGenerator<any>;
+        /** Fetch one by id. */
+        get: (id: string) => Promise<any>;
+        /** Create. */
+        create: (body: SiteCreate) => Promise<any>;
+        /** Partial update by id. */
+        update: (id: string, body: SiteUpdate) => Promise<any>;
+        /** Delete by id. */
+        delete: (id: string) => Promise<any>;
+    };
+    readonly assets: {
+        /** List one page (default 50, max 200). */
+        list: (params?: ListParams) => Promise<any[]>;
+        /** Async-iterate EVERY item across all pages (follows `meta.nextCursor`). */
+        listAll(params?: ListParams): AsyncGenerator<any>;
+        /** Fetch one by id. */
+        get: (id: string) => Promise<any>;
+        /** Create. */
+        create: (body: AssetCreate) => Promise<any>;
+        /** Partial update by id. */
+        update: (id: string, body: AssetUpdate) => Promise<any>;
+        /** Delete by id. */
+        delete: (id: string) => Promise<any>;
+    };
+    readonly campaignAssets: {
+        list: (p?: ListParams & {
+            campaignId?: string;
+            assetId?: string;
+        }) => Promise<any>;
+        get: (id: string) => Promise<any>;
+        create: (body: CampaignAssetCreate) => Promise<any>;
+        delete: (id: string) => Promise<any>;
+    };
+    readonly adAssets: {
+        list: (p?: ListParams & {
+            adId?: string;
+            adGroupId?: string;
+            campaignId?: string;
+            role?: string;
+        }) => Promise<any>;
+        get: (id: string) => Promise<any>;
+        create: (body: AdAssetCreate) => Promise<any>;
+        delete: (id: string) => Promise<any>;
+    };
+    readonly media: {
+        matrix: () => Promise<any>;
+    };
+    readonly reports: {
+        /** Performance stats; see the reference for `date_range`, `group_by`, `metrics`, etc. */
+        stats: (params?: Record<string, any>) => Promise<any>;
+    };
+    readonly sync: {
+        /** Trigger a sync for the active Space (async — poll `get(syncId)`). */
+        trigger: (body?: SyncTriggerRequest) => Promise<any>;
+        list: (p?: ListParams) => Promise<any>;
+        /** Dry-run plan (import/export/remove) without executing. */
+        plan: (p?: {
+            platforms?: string;
+        }) => Promise<any>;
+        get: (id: string) => Promise<any>;
+        cancel: (id: string) => Promise<any>;
+        /** Unlink campaigns from a platform (keeps the local campaign). */
+        unlink: (body: SyncUnlinkRequest) => Promise<any>;
+    };
+    readonly meta: {
+        /** Introspect the authenticated token. */
+        me: () => Promise<any>;
+        /** List Spaces the token can access. */
+        spaces: () => Promise<any>;
+    };
+    constructor(options: DefoAdsOptions);
+}
+
+export { AuthError, ConflictError, DefoAds, DefoAdsError, type DefoAdsOptions, ForbiddenError, NotFoundError, PRODUCTION_BASE_URL, RateLimitError, STAGING_BASE_URL, DefoAds as default };