广告活动 API#

广告活动（Campaign）是广告投放的顶层实体，用于组织和管理一组相关的广告组。

创建广告活动#

请求#

POST /v1/campaigns

请求参数#

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | name | string | 是 | 活动名称，最长 200 字符 | | budget_daily | number | 是 | 日预算，单位：USD | | marketplace | string | 是 | eBay 站点，如 EBAY_US | | start_date | string | 否 | 开始日期，格式 YYYY-MM-DD | | end_date | string | 否 | 结束日期，格式 YYYY-MM-DD |

响应示例#

{
  "id": "camp_123456",
  "name": "我的广告活动",
  "status": "active",
  "budget_daily": 50.00,
  "marketplace": "EBAY_US",
  "created_at": "2024-01-15T10:30:00Z"
}

获取广告活动列表#

请求#

GET /v1/campaigns

查询参数#

| 参数 | 类型 | 默认值 | 说明 | |------|------|--------|------| | page | number | 1 | 页码 | | page_size | number | 20 | 每页数量，最大 100 | | status | string | - | 过滤状态：active, paused, ended |

更新广告活动#

请求#

PUT /v1/campaigns/{campaign_id}

删除广告活动#

请求#

DELETE /v1/campaigns/{campaign_id}

注意：删除广告活动将同时删除其下的所有广告组和关键词。此操作不可逆。