@optima-chat/ads-cli 0.5.0

package/dist/lib/google-ads-client.js

@@ -0,0 +1,826 @@
+/**
+ * Google Ads Client - 封装 Google Ads API
+ */
+import { GoogleAdsApi, enums, toMicros } from 'google-ads-api';
+import { loadConfig } from '../utils/config.js';
+import { OAuth2Manager } from './oauth2-manager.js';
+import { GoogleAdsError } from '../utils/errors.js';
+/**
+ * Google Ads Client 封装类
+ */
+export class GoogleAdsClient {
+    api;
+    oauth;
+    config;
+    constructor() {
+        this.config = loadConfig();
+        this.oauth = new OAuth2Manager();
+        // 初始化 Google Ads API
+        this.api = new GoogleAdsApi({
+            client_id: this.config.clientId,
+            client_secret: this.config.clientSecret,
+            developer_token: this.config.developerToken,
+        });
+    }
+    /**
+     * 获取 Customer 对象（带认证）
+     */
+    async getCustomer(customerId) {
+        try {
+            // 获取 refresh token
+            const refreshToken = await this.oauth.getRefreshToken();
+            // 创建 Customer 对象
+            const customer = this.api.Customer({
+                customer_id: customerId,
+                refresh_token: refreshToken,
+                login_customer_id: this.config.loginCustomerId,
+            });
+            return customer;
+        }
+        catch (error) {
+            throw new GoogleAdsError(`无法连接到客户账号 ${customerId}: ${error.message}`, error);
+        }
+    }
+    /**
+     * 执行 GAQL 查询
+     */
+    async query(customerId, gaqlQuery) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const results = await customer.query(gaqlQuery);
+            return results;
+        }
+        catch (error) {
+            const errorMessage = error.message
+                || error.details
+                || (error.errors && JSON.stringify(error.errors))
+                || JSON.stringify(error);
+            throw new GoogleAdsError(`查询失败: ${errorMessage}`, error);
+        }
+    }
+    /**
+     * 获取客户账号信息
+     */
+    async getCustomerInfo(customerId) {
+        const query = `
+      SELECT
+        customer.id,
+        customer.descriptive_name,
+        customer.currency_code,
+        customer.time_zone,
+        customer.manager,
+        customer.test_account,
+        customer.auto_tagging_enabled,
+        customer.tracking_url_template
+      FROM customer
+      WHERE customer.id = ${customerId}
+    `;
+        const results = await this.query(customerId, query);
+        return results[0]?.customer || null;
+    }
+    /**
+     * 列出可访问的客户账号
+     */
+    async listAccessibleCustomers() {
+        try {
+            const refreshToken = await this.oauth.getRefreshToken();
+            // 使用 client.listAccessibleCustomers() 方法
+            const response = await this.api.listAccessibleCustomers(refreshToken);
+            // response 是 ListAccessibleCustomersResponse 对象，包含 resource_names 数组
+            const resourceNames = response.resource_names || [];
+            // 提取 customer ID
+            const customerIds = resourceNames
+                .map((name) => {
+                const match = name.match(/customers\/(\d+)/);
+                return match ? match[1] : null;
+            })
+                .filter((id) => id !== null);
+            return customerIds;
+        }
+        catch (error) {
+            throw new GoogleAdsError(`获取可访问账号列表失败: ${error.message}`, error);
+        }
+    }
+    /**
+     * 列出广告系列
+     */
+    async listCampaigns(customerId, options) {
+        let query = `
+      SELECT
+        campaign.id,
+        campaign.name,
+        campaign.status,
+        campaign.advertising_channel_type,
+        campaign.bidding_strategy_type,
+        campaign.campaign_budget,
+        campaign.start_date,
+        campaign.end_date,
+        metrics.impressions,
+        metrics.clicks,
+        metrics.cost_micros,
+        metrics.conversions
+      FROM campaign
+    `;
+        const conditions = [];
+        if (options?.status) {
+            conditions.push(`campaign.status = '${options.status}'`);
+        }
+        if (conditions.length > 0) {
+            query += ' WHERE ' + conditions.join(' AND ');
+        }
+        query += ' ORDER BY campaign.id';
+        if (options?.limit) {
+            query += ` LIMIT ${options.limit}`;
+        }
+        return await this.query(customerId, query);
+    }
+    /**
+     * 获取广告系列详情
+     */
+    async getCampaign(customerId, campaignId) {
+        const query = `
+      SELECT
+        campaign.id,
+        campaign.name,
+        campaign.status,
+        campaign.advertising_channel_type,
+        campaign.bidding_strategy_type,
+        campaign.campaign_budget,
+        campaign.start_date,
+        campaign.end_date,
+        campaign.target_cpa.target_cpa_micros,
+        campaign.target_roas.target_roas,
+        campaign.optimization_score,
+        metrics.impressions,
+        metrics.clicks,
+        metrics.cost_micros,
+        metrics.conversions,
+        metrics.conversions_value,
+        metrics.average_cpc,
+        metrics.average_cpm,
+        metrics.ctr
+      FROM campaign
+      WHERE campaign.id = ${campaignId}
+    `;
+        const results = await this.query(customerId, query);
+        return results[0] || null;
+    }
+    /**
+     * 列出广告组
+     */
+    async listAdGroups(customerId, campaignId, options) {
+        let query = `
+      SELECT
+        ad_group.id,
+        ad_group.name,
+        ad_group.status,
+        ad_group.type,
+        ad_group.cpc_bid_micros,
+        campaign.id,
+        campaign.name,
+        metrics.impressions,
+        metrics.clicks,
+        metrics.cost_micros,
+        metrics.conversions,
+        metrics.ctr
+      FROM ad_group
+    `;
+        const conditions = [];
+        if (campaignId) {
+            conditions.push(`campaign.id = ${campaignId}`);
+        }
+        if (options?.status) {
+            conditions.push(`ad_group.status = '${options.status}'`);
+        }
+        else {
+            // 默认不显示已删除的广告组
+            conditions.push(`ad_group.status != 'REMOVED'`);
+        }
+        if (conditions.length > 0) {
+            query += ' WHERE ' + conditions.join(' AND ');
+        }
+        query += ` LIMIT ${options?.limit || 100}`;
+        return this.query(customerId, query);
+    }
+    /**
+     * 获取广告组详情
+     */
+    async getAdGroup(customerId, adGroupId) {
+        const query = `
+      SELECT
+        ad_group.id,
+        ad_group.name,
+        ad_group.status,
+        ad_group.type,
+        ad_group.cpc_bid_micros,
+        campaign.id,
+        campaign.name,
+        metrics.impressions,
+        metrics.clicks,
+        metrics.cost_micros,
+        metrics.conversions
+      FROM ad_group
+      WHERE ad_group.id = ${adGroupId}
+    `;
+        const results = await this.query(customerId, query);
+        return results[0] || null;
+    }
+    /**
+     * 更新广告组
+     */
+    async updateAdGroup(customerId, adGroupId, updateData) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const resourceName = `customers/${customerId}/adGroups/${adGroupId}`;
+            const resource = { resource_name: resourceName };
+            if (updateData.status) {
+                resource.status = updateData.status;
+            }
+            if (updateData.name) {
+                resource.name = updateData.name;
+            }
+            if (updateData.cpcBidMicros) {
+                resource.cpc_bid_micros = updateData.cpcBidMicros;
+            }
+            const operations = [
+                {
+                    entity: 'ad_group',
+                    operation: 'update',
+                    resource: resource,
+                },
+            ];
+            const result = await customer.mutateResources(operations);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error.message || error.details || (error.errors && JSON.stringify(error.errors)) || JSON.stringify(error);
+            throw new GoogleAdsError(`更新广告组失败: ${errorMessage}`, error);
+        }
+    }
+    /**
+     * 列出关键词
+     */
+    async listKeywords(customerId, campaignId, options) {
+        let query = `
+      SELECT
+        ad_group_criterion.criterion_id,
+        ad_group_criterion.keyword.text,
+        ad_group_criterion.keyword.match_type,
+        ad_group_criterion.status,
+        ad_group_criterion.negative,
+        ad_group_criterion.quality_info.quality_score,
+        ad_group.id,
+        ad_group.name,
+        campaign.id,
+        campaign.name,
+        metrics.impressions,
+        metrics.clicks,
+        metrics.cost_micros,
+        metrics.conversions,
+        metrics.ctr,
+        metrics.average_cpc
+      FROM keyword_view
+    `;
+        const conditions = [];
+        if (campaignId) {
+            conditions.push(`campaign.id = ${campaignId}`);
+        }
+        if (options?.status) {
+            conditions.push(`ad_group_criterion.status = '${options.status}'`);
+        }
+        if (conditions.length > 0) {
+            query += ' WHERE ' + conditions.join(' AND ');
+        }
+        query += ' ORDER BY metrics.impressions DESC';
+        if (options?.limit) {
+            query += ` LIMIT ${options.limit}`;
+        }
+        return await this.query(customerId, query);
+    }
+    /**
+     * 获取效果数据
+     */
+    async getPerformanceMetrics(customerId, options) {
+        const resourceMap = {
+            campaign: 'campaign',
+            ad_group: 'ad_group',
+            keyword: 'keyword_view',
+            ad: 'ad_group_ad',
+        };
+        const resource = resourceMap[options.level];
+        let query = `SELECT `;
+        // 添加基础字段
+        const fields = [];
+        if (options.level === 'campaign') {
+            fields.push('campaign.id', 'campaign.name', 'campaign.status');
+        }
+        else if (options.level === 'ad_group') {
+            fields.push('campaign.id', 'campaign.name', 'ad_group.id', 'ad_group.name', 'ad_group.status');
+        }
+        else if (options.level === 'keyword') {
+            fields.push('campaign.id', 'campaign.name', 'ad_group.id', 'ad_group.name', 'ad_group_criterion.criterion_id', 'ad_group_criterion.keyword.text', 'ad_group_criterion.keyword.match_type');
+        }
+        else if (options.level === 'ad') {
+            fields.push('campaign.id', 'campaign.name', 'ad_group.id', 'ad_group.name', 'ad_group_ad.ad.id', 'ad_group_ad.ad.type');
+        }
+        // 添加指标
+        fields.push('metrics.impressions', 'metrics.clicks', 'metrics.cost_micros', 'metrics.conversions', 'metrics.conversions_value', 'metrics.ctr', 'metrics.average_cpc', 'metrics.average_cpm', 'metrics.cost_per_conversion');
+        // 如果有日期范围，添加日期字段
+        if (options.dateRange) {
+            fields.push('segments.date');
+        }
+        query += fields.join(', ') + ` FROM ${resource}`;
+        // 添加条件
+        const conditions = [];
+        if (options.campaignId) {
+            conditions.push(`campaign.id = ${options.campaignId}`);
+        }
+        if (options.dateRange) {
+            conditions.push(`segments.date DURING ${options.dateRange}`);
+        }
+        if (conditions.length > 0) {
+            query += ' WHERE ' + conditions.join(' AND ');
+        }
+        query += ' ORDER BY metrics.impressions DESC';
+        if (options.limit) {
+            query += ` LIMIT ${options.limit}`;
+        }
+        return await this.query(customerId, query);
+    }
+    /**
+     * 创建广告系列
+     *
+     * 使用 mutateResources API 批量创建预算和广告系列
+     */
+    async createCampaign(customerId, campaignData) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            // 创建临时资源名称
+            const budgetResourceName = `customers/${customerId}/campaignBudgets/-1`;
+            const operations = [
+                // 创建预算
+                {
+                    entity: 'campaign_budget',
+                    operation: 'create',
+                    resource: {
+                        resource_name: budgetResourceName,
+                        name: `${campaignData.name} Budget`,
+                        delivery_method: enums.BudgetDeliveryMethod.STANDARD,
+                        amount_micros: campaignData.budget_amount_micros,
+                    },
+                },
+                // 创建广告系列
+                {
+                    entity: 'campaign',
+                    operation: 'create',
+                    resource: {
+                        name: campaignData.name,
+                        advertising_channel_type: campaignData.advertising_channel_type || enums.AdvertisingChannelType.SEARCH,
+                        status: campaignData.status || enums.CampaignStatus.PAUSED,
+                        campaign_budget: budgetResourceName,
+                        manual_cpc: {
+                            enhanced_cpc_enabled: false,
+                        },
+                        // EU 政治广告合规声明（必需字段，从 2025 年 9 月开始强制要求）
+                        contains_eu_political_advertising: enums.EuPoliticalAdvertisingStatus.DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING,
+                        network_settings: {
+                            target_google_search: true,
+                        },
+                    },
+                },
+            ];
+            const result = await customer.mutateResources(operations);
+            return result;
+        }
+        catch (error) {
+            // 提取 Google Ads API 错误详情
+            let errorMessage = error.message || 'Unknown error';
+            if (error.errors && error.errors.length > 0) {
+                const firstError = error.errors[0];
+                console.error('Google Ads API Error Details:', JSON.stringify(firstError, null, 2));
+                if (firstError.message) {
+                    errorMessage = firstError.message;
+                }
+                else if (firstError.error_code) {
+                    errorMessage = `Error code: ${JSON.stringify(firstError.error_code)}`;
+                }
+            }
+            throw new GoogleAdsError(`创建广告系列失败: ${errorMessage}`, error);
+        }
+    }
+    /**
+     * 创建广告组
+     */
+    async createAdGroup(customerId, adGroupData) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const campaignResourceName = `customers/${customerId}/campaigns/${adGroupData.campaign_id}`;
+            const operations = [
+                {
+                    entity: 'ad_group',
+                    operation: 'create',
+                    resource: {
+                        name: adGroupData.name,
+                        campaign: campaignResourceName,
+                        status: adGroupData.status || enums.AdGroupStatus.ENABLED,
+                        cpc_bid_micros: adGroupData.cpc_bid_micros || toMicros(1), // 默认 $1
+                    },
+                },
+            ];
+            const result = await customer.mutateResources(operations);
+            return result;
+        }
+        catch (error) {
+            throw new GoogleAdsError(`创建广告组失败: ${error.message}`, error);
+        }
+    }
+    /**
+     * 添加关键词
+     */
+    async addKeywords(customerId, adGroupId, keywords) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const adGroupResourceName = `customers/${customerId}/adGroups/${adGroupId}`;
+            const operations = keywords.map((keyword) => ({
+                entity: 'ad_group_criterion',
+                operation: 'create',
+                resource: {
+                    ad_group: adGroupResourceName,
+                    keyword: {
+                        text: keyword.text,
+                        match_type: keyword.match_type || enums.KeywordMatchType.BROAD,
+                    },
+                    status: enums.AdGroupCriterionStatus.ENABLED,
+                },
+            }));
+            const result = await customer.mutateResources(operations);
+            return result;
+        }
+        catch (error) {
+            throw new GoogleAdsError(`添加关键词失败: ${error.message}`, error);
+        }
+    }
+    /**
+     * 删除广告系列
+     */
+    async deleteCampaign(customerId, campaignId) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const resourceName = `customers/${customerId}/campaigns/${campaignId}`;
+            const result = await customer.campaigns.remove([resourceName]);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error.message || error.details || (error.errors && JSON.stringify(error.errors)) || JSON.stringify(error);
+            throw new GoogleAdsError(`删除广告系列失败: ${errorMessage}`, error);
+        }
+    }
+    /**
+     * 删除广告组
+     */
+    async deleteAdGroup(customerId, adGroupId) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const resourceName = `customers/${customerId}/adGroups/${adGroupId}`;
+            const result = await customer.adGroups.remove([resourceName]);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error.message || error.details || (error.errors && JSON.stringify(error.errors)) || JSON.stringify(error);
+            throw new GoogleAdsError(`删除广告组失败: ${errorMessage}`, error);
+        }
+    }
+    /**
+     * 删除关键词
+     */
+    async deleteKeyword(customerId, adGroupId, criterionId) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const resourceName = `customers/${customerId}/adGroupCriteria/${adGroupId}~${criterionId}`;
+            const result = await customer.adGroupCriteria.remove([resourceName]);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error.message || error.details || (error.errors && JSON.stringify(error.errors)) || JSON.stringify(error);
+            throw new GoogleAdsError(`删除关键词失败: ${errorMessage}`, error);
+        }
+    }
+    /**
+     * 更新关键词（状态、出价）
+     */
+    async updateKeyword(customerId, adGroupId, criterionId, updateData) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const resourceName = `customers/${customerId}/adGroupCriteria/${adGroupId}~${criterionId}`;
+            const resource = { resource_name: resourceName };
+            if (updateData.status) {
+                resource.status = updateData.status;
+            }
+            if (updateData.cpcBidMicros) {
+                resource.cpc_bid_micros = updateData.cpcBidMicros;
+            }
+            const operations = [
+                {
+                    entity: 'ad_group_criterion',
+                    operation: 'update',
+                    resource: resource,
+                },
+            ];
+            const result = await customer.mutateResources(operations);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error.message || error.details || (error.errors && JSON.stringify(error.errors)) || JSON.stringify(error);
+            throw new GoogleAdsError(`更新关键词失败: ${errorMessage}`, error);
+        }
+    }
+    /**
+     * 更新广告系列状态
+     */
+    async updateCampaignStatus(customerId, campaignId, status) {
+        return this.updateCampaign(customerId, campaignId, { status });
+    }
+    /**
+     * 更新广告系列（支持状态、名称、预算）
+     */
+    async updateCampaign(customerId, campaignId, updateData) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const resourceName = `customers/${customerId}/campaigns/${campaignId}`;
+            const resource = {};
+            if (updateData.status) {
+                resource.status = updateData.status;
+            }
+            if (updateData.name) {
+                resource.name = updateData.name;
+            }
+            // 如果需要更新预算，需要先获取当前广告系列的预算资源
+            if (updateData.budgetAmountMicros) {
+                // 首先获取广告系列的预算信息
+                const campaignQuery = `
+          SELECT campaign.campaign_budget
+          FROM campaign
+          WHERE campaign.id = ${campaignId}
+        `;
+                const campaignResult = await customer.query(campaignQuery);
+                if (campaignResult.length === 0) {
+                    throw new GoogleAdsError('找不到广告系列');
+                }
+                const budgetResourceName = campaignResult[0].campaign?.campaign_budget;
+                if (budgetResourceName) {
+                    // 更新预算
+                    const budgetOperations = [
+                        {
+                            entity: 'campaign_budget',
+                            operation: 'update',
+                            resource: {
+                                resource_name: budgetResourceName,
+                                amount_micros: updateData.budgetAmountMicros,
+                            },
+                        },
+                    ];
+                    await customer.mutateResources(budgetOperations);
+                }
+            }
+            // 如果有状态或名称更新
+            if (Object.keys(resource).length > 0) {
+                resource.resource_name = resourceName;
+                const operations = [
+                    {
+                        entity: 'campaign',
+                        operation: 'update',
+                        resource: resource,
+                    },
+                ];
+                const result = await customer.mutateResources(operations);
+                return result;
+            }
+            return { success: true };
+        }
+        catch (error) {
+            const errorMessage = error.message || error.details || (error.errors && JSON.stringify(error.errors)) || JSON.stringify(error);
+            throw new GoogleAdsError(`更新广告系列失败: ${errorMessage}`, error);
+        }
+    }
+    /**
+     * 列出广告
+     */
+    async listAds(customerId, options) {
+        let query = `
+      SELECT
+        ad_group_ad.ad.id,
+        ad_group_ad.ad.type,
+        ad_group_ad.ad.final_urls,
+        ad_group_ad.ad.responsive_search_ad.headlines,
+        ad_group_ad.ad.responsive_search_ad.descriptions,
+        ad_group_ad.ad.responsive_search_ad.path1,
+        ad_group_ad.ad.responsive_search_ad.path2,
+        ad_group_ad.status,
+        ad_group_ad.policy_summary.approval_status,
+        ad_group.id,
+        ad_group.name,
+        campaign.id,
+        campaign.name,
+        metrics.impressions,
+        metrics.clicks,
+        metrics.cost_micros,
+        metrics.conversions
+      FROM ad_group_ad
+    `;
+        const conditions = [];
+        if (options?.campaignId) {
+            conditions.push(`campaign.id = ${options.campaignId}`);
+        }
+        if (options?.adGroupId) {
+            conditions.push(`ad_group.id = ${options.adGroupId}`);
+        }
+        if (options?.status) {
+            conditions.push(`ad_group_ad.status = '${options.status}'`);
+        }
+        else {
+            conditions.push(`ad_group_ad.status != 'REMOVED'`);
+        }
+        if (conditions.length > 0) {
+            query += ' WHERE ' + conditions.join(' AND ');
+        }
+        query += ` LIMIT ${options?.limit || 100}`;
+        return this.query(customerId, query);
+    }
+    /**
+     * 获取广告详情
+     */
+    async getAd(customerId, adGroupId, adId) {
+        const query = `
+      SELECT
+        ad_group_ad.ad.id,
+        ad_group_ad.ad.type,
+        ad_group_ad.ad.final_urls,
+        ad_group_ad.ad.responsive_search_ad.headlines,
+        ad_group_ad.ad.responsive_search_ad.descriptions,
+        ad_group_ad.ad.responsive_search_ad.path1,
+        ad_group_ad.ad.responsive_search_ad.path2,
+        ad_group_ad.status,
+        ad_group_ad.policy_summary.approval_status,
+        ad_group.id,
+        ad_group.name,
+        campaign.id,
+        campaign.name,
+        metrics.impressions,
+        metrics.clicks,
+        metrics.cost_micros,
+        metrics.conversions
+      FROM ad_group_ad
+      WHERE ad_group.id = ${adGroupId} AND ad_group_ad.ad.id = ${adId}
+    `;
+        const results = await this.query(customerId, query);
+        return results[0] || null;
+    }
+    /**
+     * 更新广告状态
+     */
+    async updateAd(customerId, adGroupId, adId, updateData) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const resourceName = `customers/${customerId}/adGroupAds/${adGroupId}~${adId}`;
+            const resource = { resource_name: resourceName };
+            if (updateData.status) {
+                resource.status = updateData.status;
+            }
+            const operations = [
+                {
+                    entity: 'ad_group_ad',
+                    operation: 'update',
+                    resource: resource,
+                },
+            ];
+            const result = await customer.mutateResources(operations);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error.message || error.details || (error.errors && JSON.stringify(error.errors)) || JSON.stringify(error);
+            throw new GoogleAdsError(`更新广告失败: ${errorMessage}`, error);
+        }
+    }
+    /**
+     * 创建响应式搜索广告 (RSA)
+     */
+    async createAd(customerId, adData) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const operations = [
+                {
+                    entity: 'ad_group_ad',
+                    operation: 'create',
+                    resource: {
+                        ad_group: `customers/${customerId}/adGroups/${adData.adGroupId}`,
+                        status: adData.status === 'ENABLED' ? enums.AdGroupAdStatus.ENABLED : enums.AdGroupAdStatus.PAUSED,
+                        ad: {
+                            responsive_search_ad: {
+                                headlines: adData.headlines.map(text => ({ text })),
+                                descriptions: adData.descriptions.map(text => ({ text })),
+                                path1: adData.path1,
+                                path2: adData.path2,
+                            },
+                            final_urls: [adData.finalUrl],
+                        },
+                    },
+                },
+            ];
+            const result = await customer.mutateResources(operations);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error.message || error.details || (error.errors && JSON.stringify(error.errors)) || JSON.stringify(error);
+            throw new GoogleAdsError(`创建广告失败: ${errorMessage}`, error);
+        }
+    }
+    /**
+     * 删除广告
+     */
+    async deleteAd(customerId, adGroupId, adId) {
+        try {
+            const customer = await this.getCustomer(customerId);
+            const resourceName = `customers/${customerId}/adGroupAds/${adGroupId}~${adId}`;
+            const result = await customer.adGroupAds.remove([resourceName]);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = error.message || error.details || (error.errors && JSON.stringify(error.errors)) || JSON.stringify(error);
+            throw new GoogleAdsError(`删除广告失败: ${errorMessage}`, error);
+        }
+    }
+    /**
+     * 发送 MCC 关联邀请
+     * 从 Manager Account (MCC) 向客户账号发送关联邀请
+     *
+     * @param clientCustomerId 客户账号的 Customer ID
+     * @returns manager_link_id 用于客户接受邀请
+     */
+    async sendLinkInvitation(clientCustomerId) {
+        try {
+            // 使用 MCC 账号发送邀请
+            const managerCustomerId = this.config.loginCustomerId;
+            if (!managerCustomerId) {
+                throw new GoogleAdsError('未配置 MCC 管理账号 ID\n' +
+                    '请在 .env 文件中设置 GOOGLE_ADS_MANAGER_ACCOUNT_ID');
+            }
+            const manager = await this.getCustomer(managerCustomerId);
+            // 先检查是否已存在关联
+            const existingQuery = `
+        SELECT
+          customer_client_link.client_customer,
+          customer_client_link.manager_link_id,
+          customer_client_link.status
+        FROM customer_client_link
+        WHERE customer_client_link.client_customer = 'customers/${clientCustomerId}'
+      `;
+            const existingLinks = await manager.query(existingQuery);
+            if (existingLinks.length > 0) {
+                const existingLink = existingLinks[0]?.customer_client_link;
+                if (existingLink?.manager_link_id) {
+                    // 已存在关联，返回现有的 manager_link_id
+                    return `existing:${existingLink.manager_link_id}`;
+                }
+            }
+            // 直接调用底层的 CustomerClientLinkService
+            // 注意：封装的 customerClientLinks.create 方法有 bug，需要直接调用 gRPC 服务
+            const service = manager.loadService('CustomerClientLinkServiceClient');
+            const operation = {
+                create: {
+                    client_customer: `customers/${clientCustomerId}`,
+                    status: enums.ManagerLinkStatus.PENDING,
+                },
+            };
+            const request = {
+                customer_id: managerCustomerId,
+                operation: operation,
+            };
+            const [response] = await service.mutateCustomerClientLink(request, {
+                otherArgs: {
+                    headers: {
+                        'developer-token': this.config.developerToken,
+                        'login-customer-id': managerCustomerId,
+                    },
+                },
+            });
+            // 从 resource_name 提取 manager_link_id
+            // 格式: customers/{manager_id}/customerClientLinks/{client_id}~{manager_link_id}
+            const resourceName = response?.result?.resource_name;
+            if (!resourceName) {
+                throw new GoogleAdsError('创建关联成功但未返回 resource_name');
+            }
+            const match = resourceName.match(/~(\d+)$/);
+            const managerLinkId = match ? match[1] : 'unknown';
+            return managerLinkId;
+        }
+        catch (error) {
+            // 提取更详细的错误信息
+            const errorMessage = error.message
+                || error.details
+                || (error.errors && JSON.stringify(error.errors))
+                || JSON.stringify(error);
+            throw new GoogleAdsError(`发送关联邀请失败: ${errorMessage}`, error);
+        }
+    }
+}
+//# sourceMappingURL=google-ads-client.js.map