siluzan-tso-cli 1.0.0-beta.10

package/dist/commands/open-account.d.ts

@@ -0,0 +1,291 @@
+import type { AdsConfig } from "../types/ads.js";
+export interface ListGroupsOptions {
+    token?: string;
+    json?: boolean;
+    verbose?: boolean;
+}
+/**
+ * 查询当前账号下的广告主组列表。
+ * GET /query/profile/steward-individual
+ *
+ * 接口返回完整 profile 对象，广告主组在 profile.mediaAccountGroups 中。
+ * 每个广告主组的 key 字段即为开户时需要的 MediaAccountGroupId（magKey）。
+ */
+export declare function runListAdvertiserGroups(opts: ListGroupsOptions): Promise<void>;
+export interface OpenAccountYandexOptions {
+    token?: string;
+    /** 公司名称（广告主名称），用于自动创建/匹配广告主组，与网页行为一致 */
+    company: string;
+    /** 可选：手动指定广告主组 magKey，指定后跳过自动创建/匹配逻辑 */
+    advertiserId?: string;
+    /** Yandex 登录名（英文字母 + 数字，不含空格） */
+    login: string;
+    firstName: string;
+    lastName: string;
+    /** 通知邮箱 */
+    email: string;
+    /** 税号 (Tin / INN)，类型固定为 FOREIGN_LEGAL */
+    tin: string;
+    /** 联系电话 */
+    phone: string;
+    /** 税务编号（TaxpayerNumber）*/
+    taxpayerNumber?: string;
+    /** 官网地址 */
+    webUrl?: string;
+    verbose?: boolean;
+}
+/**
+ * 提交 Yandex 开户申请（无图片，全部为文字参数）。
+ * 流程：按公司名自动创建/匹配广告主组（与网页一致）→ POST /command/media-account/AddAgencyClient
+ */
+export declare function runOpenAccountYandex(opts: OpenAccountYandexOptions): Promise<void>;
+export interface OpenAccountBingOptions {
+    token?: string;
+    /** 可选：手动指定广告主组 magKey，指定后跳过自动创建/匹配逻辑 */
+    advertiserId?: string;
+    /** 广告主名称（公司全称），用于自动创建/匹配广告主组，与网页行为一致 */
+    advertiserName: string;
+    /** 简称 */
+    nameShort: string;
+    /** 省/州 */
+    province: string;
+    /** 城市 */
+    city: string;
+    /** 邮编 */
+    postcode?: string;
+    /** 详细地址 */
+    address: string;
+    /** 推广链接 */
+    promotionLink: string;
+    /** 行业名称（来自 open-account bing-industries 的 name 字段） */
+    tradeId: string;
+    /** 经理账户 CID（AdvertiserCid）*/
+    advertiserCid?: string;
+    /** 经理账户名称（AdvertiserName）*/
+    advertiserName2?: string;
+    /** 账户数量，默认 1 */
+    accountCount?: number;
+    /** 本地营业执照文件路径（必填，用于上传 FileId） */
+    licenseFile: string;
+    verbose?: boolean;
+}
+/**
+ * 提交 Bing/BingV2 开户申请。
+ * 流程：先上传营业执照 → 自动创建/匹配广告主组 → 提交开户请求。
+ * 与网页 bingOpenAnAccount.vue 行为一致，用户只需填公司名，无需关心 magKey。
+ * POST /command/media-account/AddBingV2Account
+ */
+export declare function runOpenAccountBing(opts: OpenAccountBingOptions): Promise<void>;
+export interface OpenAccountKwaiOptions {
+    token?: string;
+    /** 可选：手动指定广告主组 magKey，指定后跳过自动创建/匹配逻辑 */
+    advertiserId?: string;
+    /** 主体代码（营业执照号） */
+    licenceId: string;
+    /** 主体注册国家代码，如 CN */
+    licenceCountry: string;
+    /** 主体注册地（省市区详细地址） */
+    licenceLocation: string;
+    /** 营业范围 */
+    businessScope: string;
+    /** 产品/品牌名称 */
+    product: string;
+    /** 账户类型：1=效果广告 2=品牌广告 */
+    adType: number;
+    /** 产品或品牌网址 */
+    productUrl: string;
+    /** 实体类型，如 INDIVIDUAL 或 ENTERPRISE */
+    licenceIdType: string;
+    /** 账户名称 */
+    accountName: string;
+    /** 公司主体名称 */
+    companyName: string;
+    /** 一级行业 ID（来自 Kwai 行业列表） */
+    industryId1: string;
+    /** 二级行业 ID */
+    industryId2: string;
+    /** 有效期类型：1=有限期 2=长期有效 */
+    expireType: number;
+    /** 到期时间戳（毫秒），expireType=1 时填写，expireType=2 时为 0 */
+    expireAt?: number;
+    /** 投放地区国家代码，如 US */
+    targetCountry: string;
+    /** 本地营业执照文件路径（图片将上传至 Kwai，获取 blobstoreKey） */
+    licenseFile: string;
+    verbose?: boolean;
+}
+/**
+ * 提交 Kwai 开户申请。
+ * 流程：先上传营业执照图片至 Kwai → 自动创建/匹配广告主组 → 提交开户请求。
+ * 与网页 KwaiOpenAnAccount.vue 行为一致，用户只需填公司名，无需关心 magKey。
+ * POST /command/media-account/AddKwaiAccount
+ */
+export declare function runOpenAccountKwai(opts: OpenAccountKwaiOptions): Promise<void>;
+/** 与 openAnAccount.vue 中 timezonelist() 使用的行结构一致 */
+export interface GoogleTimezoneRow {
+    Code?: string;
+    Name?: string;
+    Time?: string;
+    [key: string]: unknown;
+}
+export interface OpenAccountGoogleTimezonesOptions {
+    token?: string;
+    json?: boolean;
+    verbose?: boolean;
+    /** 按 Code / Name / 展示文案过滤（忽略大小写） */
+    keyword?: string;
+}
+/**
+ * GET /query/media-account/Google/TimeZoneInfo/ReadFile
+ * 与网页「第二步」广告账户表格里时区下拉同一数据源。
+ */
+export declare function fetchGoogleTimezoneRows(config: AdsConfig, verbose?: boolean): Promise<GoogleTimezoneRow[]>;
+export declare function runOpenAccountGoogleTimezones(opts: OpenAccountGoogleTimezonesOptions): Promise<void>;
+export interface OpenAccountGoogleWizardOptions {
+    token?: string;
+    verbose?: boolean;
+}
+/**
+ * 交互式 Google 开户向导：字段顺序与网页 openAnAccount（Google）两步表单一致，
+ * 并说明顶部「五步」进度条含义（CLI 只能代劳前两步的数据采集与提交）。
+ */
+export declare function runOpenAccountGoogleWizard(opts: OpenAccountGoogleWizardOptions): Promise<void>;
+export interface OpenAccountGoogleOptions {
+    token?: string;
+    /**
+     * 广告主组 magKey（与网页「广告主组」对应）。
+     * 一般无需填写：CLI 会按「公司名称」在后台查找或创建广告主组，与网页第一步一致。
+     */
+    advertiserId?: string;
+    /** 广告账户名称（显示名，每条最多 22 个字符） */
+    accountName: string;
+    /** 货币：USD | CNY */
+    currency: string;
+    /** 时区，如 Asia/Hong_Kong（来自 Google 时区列表）*/
+    timezone: string;
+    /** 受邀用户邮箱（必须是 .com 结尾的邮箱，账户将发送邀请至该邮箱） */
+    inviteEmail: string;
+    /** 受邀用户角色：Standard | Admin（默认 Standard）*/
+    inviteRole?: string;
+    /** 公司名称 */
+    company: string;
+    /** 行业一级（可选；网页端已弱化，不传则按空处理） */
+    industryLevel1?: string;
+    /** 行业二级（可选） */
+    industryLevel2?: string;
+    /** 推广链接（公司官网或产品页） */
+    promotionLink: string;
+    /** 推广类型：b2b | b2c | app */
+    promotionType: string;
+    /** 是否自动分配邮箱（默认 false） */
+    autoAllotMailbox?: boolean;
+    /** 本次开户数量（1-3，默认 1） */
+    counts?: number;
+    /** MCC 经理账户 ID（可选） */
+    managerCustomerId?: string;
+    verbose?: boolean;
+}
+/**
+ * 提交 Google 开户申请（无需图片，无 OAuth 跳转）。
+ * POST /command/media-account/google
+ * Header: s-command-type: AddExistingMediaAccountList
+ *
+ * 未传 advertiserId 时，会先 PUT 创建/更新广告主组（与网页一致），再提交开户。
+ * customer_info.industry 格式为 "level1-level2"；不传行业时多为 "-" 或空串，与网页当前行为对齐。
+ */
+export declare function runOpenAccountGoogle(opts: OpenAccountGoogleOptions): Promise<void>;
+export interface OpenAccountTikTokOptions {
+    token?: string;
+    /** 可选：手动指定广告主组 magKey，指定后跳过自动创建/匹配逻辑 */
+    advertiserId?: string;
+    /** 广告账户名称 */
+    accountName: string;
+    /** 货币：USD | CNY */
+    currency: string;
+    /** 时区，如 UTC+8（来自 TikTok 时区列表） */
+    timezone: string;
+    /** 公司名称 */
+    company: string;
+    /** 行业 ID（数字，从 TikTok 行业列表的叶子节点取值） */
+    industryId: number;
+    /** 注册地国家代码，如 CN */
+    registeredArea: string;
+    /** 推广链接 */
+    promotionLink: string;
+    /** 营业执照编码（社会信用代码）*/
+    licenseNo: string;
+    /** 本地营业执照图片路径（将同时上传到 TikTok 和 Siluzan 存档）*/
+    licenseFile: string;
+    /** 业务中心类型：Shop | Store | App | B2B | Other（默认 Shop）*/
+    businessCentreType?: string;
+    /** BC 合作伙伴 ID（可选，即 bc_id）*/
+    partnerId?: string;
+    /** 法人姓名（若接口要求 unionpay 验证时才需要）*/
+    representativeName?: string;
+    /** 法人身份证号 */
+    representativeId?: string;
+    /** 法人银联账号 */
+    unionpayAccount?: string;
+    /** 法人手机号 */
+    representativePhone?: string;
+    /** 本次开户数量（1-10，默认 1） */
+    counts?: number;
+    verbose?: boolean;
+}
+/**
+ * 提交 TikTok 开户申请。
+ * 流程：
+ * 1. 上传营业执照到 TikTok → 获取 license_image_id
+ * 2. 上传营业执照到 Siluzan 附件系统 → 获取 imageId（存档 + MAG 用）
+ * 3. 按公司名自动创建/匹配广告主组（与网页 openAnAccount.vue 第一步一致）
+ * 4. 查询是否需要法人银联验证信息
+ * 5. POST /command/media-account（Header: s-command-type: AddExistingMediaAccountList）
+ */
+export declare function runOpenAccountTikTok(opts: OpenAccountTikTokOptions): Promise<void>;
+export interface OpenAccountTikTokTimezonesOptions {
+    token?: string;
+    json?: boolean;
+    keyword?: string;
+    verbose?: boolean;
+}
+/**
+ * GET /query/media-account/tiktok/TikTokTimeZoneInfo/Read
+ * 与网页 openAnAccount（TikTok）时区下拉同一数据源，结构与 Google 时区接口一致。
+ */
+export declare function runOpenAccountTikTokTimezones(opts: OpenAccountTikTokTimezonesOptions): Promise<void>;
+export interface OpenAccountTikTokIndustriesOptions {
+    token?: string;
+    json?: boolean;
+    keyword?: string;
+    verbose?: boolean;
+}
+/**
+ * GET /query/media-account/tiktok/TikTokIndustryInfo/Read
+ * 返回 TikTok 行业列表，前端以两级 Cascader 展示。
+ * ID 第 5-6 位（0-indexed 4-5）为 "01" 的是一级分类，其余与同一级 2-4 位相同的是其子项。
+ * 提交开户时只传叶子节点 ID（--industry-id）。
+ */
+export declare function runOpenAccountTikTokIndustries(opts: OpenAccountTikTokIndustriesOptions): Promise<void>;
+export interface OpenAccountTikTokAreasOptions {
+    token?: string;
+    json?: boolean;
+    keyword?: string;
+    verbose?: boolean;
+}
+export interface OpenAccountBingIndustriesOptions {
+    token?: string;
+    json?: boolean;
+    keyword?: string;
+    verbose?: boolean;
+}
+/**
+ * GET /query/media-account/bing/BingTradeList/Read
+ * 返回 BingV2 行业列表（中文名），name 字段即为 --trade-id 的传入值。
+ */
+export declare function runOpenAccountBingIndustries(opts: OpenAccountBingIndustriesOptions): Promise<void>;
+/**
+ * GET /query/media-account/tiktok/TikTokAreacode/Read
+ * 返回 TikTok 注册地（--registered-area）的合法值列表。
+ * Key 为提交值（如 "CN"），Value 为显示名。
+ */
+export declare function runOpenAccountTikTokAreas(opts: OpenAccountTikTokAreasOptions): Promise<void>;