@defoai/ads-client 1.4.0

package/README.md

@@ -0,0 +1,88 @@
+# @defoai/ads-client
+
+The official TypeScript SDK for [Defo Ads](https://ads.defoai.com). Manage campaigns, ads, keywords, sites and syncs with a few lines of code — no hand-rolled HTTP, no guessing.
+
+Works anywhere `fetch` does: Node 18+, edge functions, the browser. Zero dependencies.
+
+## Install
+
+```bash
+npm install @defoai/ads-client
+```
+
+## 30-second start
+
+```ts
+import { DefoAds } from '@defoai/ads-client';
+
+const defo = new DefoAds({ token: process.env.DEFOADS_TOKEN! });
+
+// Make a campaign
+const campaign = await defo.campaigns.create({ name: 'Spring Launch', budget: 50 });
+
+// Loop over all of them (pagination is handled for you)
+for await (const c of defo.campaigns.listAll()) {
+  console.log(c.name);
+}
+```
+
+Grab a token in the app under **Settings → Developer → API tokens** (or right from the [API reference](https://ads.defoai.com/docs/api)). It looks like `dads_…`.
+
+## The good stuff (it's all built in)
+
+- **Auth** — pass your token once, every request is signed.
+- **Spaces** — set `space` once and every call is scoped to it. Skip it to use your personal space.
+- **Pagination that doesn't make you think** — `list()` gives you a page, `listAll()` gives you everything via an async iterator.
+- **Retries** — rate-limited or hit a hiccup? We back off and retry (respecting `Retry-After`) so you don't have to.
+- **Errors you can actually catch** — real error types, not status-code spelunking.
+
+```ts
+const defo = new DefoAds({
+  token: 'dads_…',
+  space: 'spc_…',   // optional — your default workspace
+});
+```
+
+## Catching errors
+
+```ts
+import { NotFoundError } from '@defoai/ads-client';
+
+try {
+  await defo.campaigns.get('nope');
+} catch (err) {
+  if (err instanceof NotFoundError) console.log("that campaign doesn't exist");
+  else throw err;
+}
+```
+
+You also get `AuthError` (bad token), `ForbiddenError` (missing scope), `ConflictError` and `RateLimitError`. Each carries `status`, `code` and `details` from the API.
+
+## What you can reach
+
+`campaigns`, `adGroups`, `ads`, `keywords`, `sites`, `assets`, `campaignAssets`, `adAssets` — each with `list` / `listAll` / `get` / `create` / `update` / `delete` where it makes sense. Plus:
+
+```ts
+await defo.reports.stats({ date_range: 'last_7d' });
+await defo.sync.trigger();
+await defo.media.matrix();
+await defo.meta.me();
+```
+
+Need something lower-level? The full generated client is exported too.
+
+## How this stays correct
+
+This SDK is generated from Defo Ads' live OpenAPI spec on every release, and a CI check blocks any release that would break the contract. So it never drifts from the real API — and neither do [the docs](https://ads.defoai.com/docs/api). The friendly bits (the client, retries, pagination, errors) are hand-written in [`src/index.ts`](src/index.ts); the wire layer in `src/generated/` is generated — don't edit it by hand.
+
+## Hacking on it
+
+```bash
+npm install
+npm run build      # → dist/
+npm test           # fast, no network
+```
+
+Found a bug, or want a method we don't expose nicely yet? [Open an issue](https://github.com/defoAI/defo-ads-typescript/issues) — we'd love the nudge.
+
+MIT licensed. Built with care by the Defo Ads team.

package/dist/generated/apis/AdAssetsApi.d.ts

@@ -0,0 +1,140 @@
+/**
+ * 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.
+ */
+import * as runtime from '../runtime';
+import type { AdAssetCreate, CampaignsListCursorParameter, SuccessEnvelope } from '../models/index';
+export interface AdAssetsCreateRequest {
+    adAssetCreate: AdAssetCreate;
+    xSpaceId?: string;
+}
+export interface AdAssetsDeleteRequest {
+    id: string;
+    xSpaceId?: string;
+}
+export interface AdAssetsGetRequest {
+    id: string;
+    xSpaceId?: string;
+}
+export interface AdAssetsListRequest {
+    limit?: number;
+    cursor?: CampaignsListCursorParameter;
+    adId?: string;
+    adGroupId?: string;
+    campaignId?: string;
+    role?: string;
+    xSpaceId?: string;
+}
+/**
+ * AdAssetsApi - interface
+ *
+ * @export
+ * @interface AdAssetsApiInterface
+ */
+export interface AdAssetsApiInterface {
+    /**
+     *
+     * @summary Bind an asset to an ad or ad group with a role
+     * @param {AdAssetCreate} adAssetCreate
+     * @param {string} [xSpaceId] Target Space ID (e.g. `spc_…`). Omit to use the caller\'s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdAssetsApiInterface
+     */
+    adAssetsCreateRaw(requestParameters: AdAssetsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Bind an asset to an ad or ad group with a role
+     */
+    adAssetsCreate(requestParameters: AdAssetsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     *
+     * @summary Remove an ad-asset binding
+     * @param {string} id
+     * @param {string} [xSpaceId] Target Space ID (e.g. &#x60;spc_…&#x60;). Omit to use the caller\&#39;s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdAssetsApiInterface
+     */
+    adAssetsDeleteRaw(requestParameters: AdAssetsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Remove an ad-asset binding
+     */
+    adAssetsDelete(requestParameters: AdAssetsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     *
+     * @summary Get ad-asset binding
+     * @param {string} id
+     * @param {string} [xSpaceId] Target Space ID (e.g. &#x60;spc_…&#x60;). Omit to use the caller\&#39;s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdAssetsApiInterface
+     */
+    adAssetsGetRaw(requestParameters: AdAssetsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Get ad-asset binding
+     */
+    adAssetsGet(requestParameters: AdAssetsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     *
+     * @summary List ad / ad-group asset bindings (filter by adId/adGroupId/campaignId)
+     * @param {number} [limit] Maximum items to return. Default 50, max 200.
+     * @param {CampaignsListCursorParameter} [cursor] Opaque pagination cursor returned by the previous page in &#x60;meta.nextCursor&#x60;.
+     * @param {string} [adId] Restrict to bindings for a specific ad.
+     * @param {string} [adGroupId] Restrict to bindings for a specific ad group.
+     * @param {string} [campaignId] All ad/ad-group bindings across a campaign.
+     * @param {string} [role] Filter by asset role.
+     * @param {string} [xSpaceId] Target Space ID (e.g. &#x60;spc_…&#x60;). Omit to use the caller\&#39;s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdAssetsApiInterface
+     */
+    adAssetsListRaw(requestParameters: AdAssetsListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * List ad / ad-group asset bindings (filter by adId/adGroupId/campaignId)
+     */
+    adAssetsList(requestParameters: AdAssetsListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+}
+/**
+ *
+ */
+export declare class AdAssetsApi extends runtime.BaseAPI implements AdAssetsApiInterface {
+    /**
+     * Bind an asset to an ad or ad group with a role
+     */
+    adAssetsCreateRaw(requestParameters: AdAssetsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Bind an asset to an ad or ad group with a role
+     */
+    adAssetsCreate(requestParameters: AdAssetsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     * Remove an ad-asset binding
+     */
+    adAssetsDeleteRaw(requestParameters: AdAssetsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Remove an ad-asset binding
+     */
+    adAssetsDelete(requestParameters: AdAssetsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     * Get ad-asset binding
+     */
+    adAssetsGetRaw(requestParameters: AdAssetsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Get ad-asset binding
+     */
+    adAssetsGet(requestParameters: AdAssetsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     * List ad / ad-group asset bindings (filter by adId/adGroupId/campaignId)
+     */
+    adAssetsListRaw(requestParameters: AdAssetsListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * List ad / ad-group asset bindings (filter by adId/adGroupId/campaignId)
+     */
+    adAssetsList(requestParameters?: AdAssetsListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+}

package/dist/generated/apis/AdAssetsApi.js

@@ -0,0 +1,173 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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.
+ */
+import * as runtime from '../runtime';
+import { AdAssetCreateToJSON, SuccessEnvelopeFromJSON, } from '../models/index';
+/**
+ *
+ */
+export class AdAssetsApi extends runtime.BaseAPI {
+    /**
+     * Bind an asset to an ad or ad group with a role
+     */
+    async adAssetsCreateRaw(requestParameters, initOverrides) {
+        if (requestParameters['adAssetCreate'] == null) {
+            throw new runtime.RequiredError('adAssetCreate', 'Required parameter "adAssetCreate" was null or undefined when calling adAssetsCreate().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (requestParameters['xSpaceId'] != null) {
+            headerParameters['X-Space-Id'] = String(requestParameters['xSpaceId']);
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiToken", ["ads:write"]);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/v1/ad-assets`,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: AdAssetCreateToJSON(requestParameters['adAssetCreate']),
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuccessEnvelopeFromJSON(jsonValue));
+    }
+    /**
+     * Bind an asset to an ad or ad group with a role
+     */
+    async adAssetsCreate(requestParameters, initOverrides) {
+        const response = await this.adAssetsCreateRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Remove an ad-asset binding
+     */
+    async adAssetsDeleteRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling adAssetsDelete().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (requestParameters['xSpaceId'] != null) {
+            headerParameters['X-Space-Id'] = String(requestParameters['xSpaceId']);
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiToken", ["ads:write"]);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/v1/ad-assets/{id}`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuccessEnvelopeFromJSON(jsonValue));
+    }
+    /**
+     * Remove an ad-asset binding
+     */
+    async adAssetsDelete(requestParameters, initOverrides) {
+        const response = await this.adAssetsDeleteRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * Get ad-asset binding
+     */
+    async adAssetsGetRaw(requestParameters, initOverrides) {
+        if (requestParameters['id'] == null) {
+            throw new runtime.RequiredError('id', 'Required parameter "id" was null or undefined when calling adAssetsGet().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        if (requestParameters['xSpaceId'] != null) {
+            headerParameters['X-Space-Id'] = String(requestParameters['xSpaceId']);
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiToken", ["ads:read"]);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/v1/ad-assets/{id}`.replace(`{${"id"}}`, encodeURIComponent(String(requestParameters['id']))),
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuccessEnvelopeFromJSON(jsonValue));
+    }
+    /**
+     * Get ad-asset binding
+     */
+    async adAssetsGet(requestParameters, initOverrides) {
+        const response = await this.adAssetsGetRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+    /**
+     * List ad / ad-group asset bindings (filter by adId/adGroupId/campaignId)
+     */
+    async adAssetsListRaw(requestParameters, initOverrides) {
+        const queryParameters = {};
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+        if (requestParameters['adId'] != null) {
+            queryParameters['adId'] = requestParameters['adId'];
+        }
+        if (requestParameters['adGroupId'] != null) {
+            queryParameters['adGroupId'] = requestParameters['adGroupId'];
+        }
+        if (requestParameters['campaignId'] != null) {
+            queryParameters['campaignId'] = requestParameters['campaignId'];
+        }
+        if (requestParameters['role'] != null) {
+            queryParameters['role'] = requestParameters['role'];
+        }
+        const headerParameters = {};
+        if (requestParameters['xSpaceId'] != null) {
+            headerParameters['X-Space-Id'] = String(requestParameters['xSpaceId']);
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("ApiToken", ["ads:read"]);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const response = await this.request({
+            path: `/api/v1/ad-assets`,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => SuccessEnvelopeFromJSON(jsonValue));
+    }
+    /**
+     * List ad / ad-group asset bindings (filter by adId/adGroupId/campaignId)
+     */
+    async adAssetsList(requestParameters = {}, initOverrides) {
+        const response = await this.adAssetsListRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+}

package/dist/generated/apis/AdGroupsApi.d.ts

@@ -0,0 +1,165 @@
+/**
+ * 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.
+ */
+import * as runtime from '../runtime';
+import type { AdGroupCreate, AdGroupUpdate, CampaignsListCursorParameter, SuccessEnvelope } from '../models/index';
+export interface AdGroupsCreateRequest {
+    adGroupCreate: AdGroupCreate;
+    xSpaceId?: string;
+}
+export interface AdGroupsDeleteRequest {
+    id: string;
+    cascade?: boolean;
+    xSpaceId?: string;
+}
+export interface AdGroupsGetRequest {
+    id: string;
+    xSpaceId?: string;
+}
+export interface AdGroupsListRequest {
+    limit?: number;
+    cursor?: CampaignsListCursorParameter;
+    xSpaceId?: string;
+}
+export interface AdGroupsUpdateRequest {
+    id: string;
+    adGroupUpdate: AdGroupUpdate;
+    xSpaceId?: string;
+}
+/**
+ * AdGroupsApi - interface
+ *
+ * @export
+ * @interface AdGroupsApiInterface
+ */
+export interface AdGroupsApiInterface {
+    /**
+     *
+     * @summary Create ad group
+     * @param {AdGroupCreate} adGroupCreate
+     * @param {string} [xSpaceId] Target Space ID (e.g. `spc_…`). Omit to use the caller\'s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdGroupsApiInterface
+     */
+    adGroupsCreateRaw(requestParameters: AdGroupsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Create ad group
+     */
+    adGroupsCreate(requestParameters: AdGroupsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     * Returns 409 CONFLICT with `details: { ads, keywords }` when the ad group still has dependent ads or keywords. Pass `?cascade=true` to delete them in the same request.
+     * @summary Delete ad group
+     * @param {string} id
+     * @param {boolean} [cascade] Set to &#x60;true&#x60; to delete dependent ads and keywords along with the ad group.
+     * @param {string} [xSpaceId] Target Space ID (e.g. &#x60;spc_…&#x60;). Omit to use the caller\&#39;s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdGroupsApiInterface
+     */
+    adGroupsDeleteRaw(requestParameters: AdGroupsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Returns 409 CONFLICT with `details: { ads, keywords }` when the ad group still has dependent ads or keywords. Pass `?cascade=true` to delete them in the same request.
+     * Delete ad group
+     */
+    adGroupsDelete(requestParameters: AdGroupsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     *
+     * @summary Get ad group
+     * @param {string} id
+     * @param {string} [xSpaceId] Target Space ID (e.g. &#x60;spc_…&#x60;). Omit to use the caller\&#39;s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdGroupsApiInterface
+     */
+    adGroupsGetRaw(requestParameters: AdGroupsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Get ad group
+     */
+    adGroupsGet(requestParameters: AdGroupsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     *
+     * @summary List ad groups
+     * @param {number} [limit] Maximum items to return. Default 50, max 200.
+     * @param {CampaignsListCursorParameter} [cursor] Opaque pagination cursor returned by the previous page in &#x60;meta.nextCursor&#x60;.
+     * @param {string} [xSpaceId] Target Space ID (e.g. &#x60;spc_…&#x60;). Omit to use the caller\&#39;s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdGroupsApiInterface
+     */
+    adGroupsListRaw(requestParameters: AdGroupsListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * List ad groups
+     */
+    adGroupsList(requestParameters: AdGroupsListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     *
+     * @summary Update ad group
+     * @param {string} id
+     * @param {AdGroupUpdate} adGroupUpdate
+     * @param {string} [xSpaceId] Target Space ID (e.g. &#x60;spc_…&#x60;). Omit to use the caller\&#39;s Personal Space. Invalid Space → 404 SPACE_NOT_FOUND; non-member → 403 NOT_A_MEMBER.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AdGroupsApiInterface
+     */
+    adGroupsUpdateRaw(requestParameters: AdGroupsUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Update ad group
+     */
+    adGroupsUpdate(requestParameters: AdGroupsUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+}
+/**
+ *
+ */
+export declare class AdGroupsApi extends runtime.BaseAPI implements AdGroupsApiInterface {
+    /**
+     * Create ad group
+     */
+    adGroupsCreateRaw(requestParameters: AdGroupsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Create ad group
+     */
+    adGroupsCreate(requestParameters: AdGroupsCreateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     * Returns 409 CONFLICT with `details: { ads, keywords }` when the ad group still has dependent ads or keywords. Pass `?cascade=true` to delete them in the same request.
+     * Delete ad group
+     */
+    adGroupsDeleteRaw(requestParameters: AdGroupsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Returns 409 CONFLICT with `details: { ads, keywords }` when the ad group still has dependent ads or keywords. Pass `?cascade=true` to delete them in the same request.
+     * Delete ad group
+     */
+    adGroupsDelete(requestParameters: AdGroupsDeleteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     * Get ad group
+     */
+    adGroupsGetRaw(requestParameters: AdGroupsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Get ad group
+     */
+    adGroupsGet(requestParameters: AdGroupsGetRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     * List ad groups
+     */
+    adGroupsListRaw(requestParameters: AdGroupsListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * List ad groups
+     */
+    adGroupsList(requestParameters?: AdGroupsListRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+    /**
+     * Update ad group
+     */
+    adGroupsUpdateRaw(requestParameters: AdGroupsUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SuccessEnvelope>>;
+    /**
+     * Update ad group
+     */
+    adGroupsUpdate(requestParameters: AdGroupsUpdateRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SuccessEnvelope>;
+}