在快照中包含预算规则值

快照功能允许您异步批量检索广告活动和关键词的记录。

使用以下表格了解根据广告类型请求快照时需使用的接口：

广告类型	快照请求接口
品牌推广	POST /v2/hsa/{recordType}/snapshot
商品推广	POST /v2/sp/{recordType}/snapshot
展示型推广	POST /v2/sd/{recordType}/snapshot

如果您已经在使用快照 API 批量检索数据，则无需对请求进行任何更改。如果您对广告活动创建了预算规则，并且规则预算当前已应用，则快照响应中将包含 ruleBasedBudget 对象。

ruleBasedBudget 对象包含以下属性：

1. value：基于规则的预算的值
2. applicableRuleId：活动规则的标识符
3. applicableRuleName：活动规则的名称
4. isProcessing：如果规则评估正在进行中，则设置为 true。当评估完成并更新规则预算数值时，设置为 **false **。

自 2023 年 2 月起，您可以通过存在 ruleBasedBudget 对象来判断预算规则是否已应用，并使用 GET /sb/campaigns/{campaignId}/budgetRules.来获取该广告活动的完整预算规则历史记录。状态为 ACTIVE 的预算规则正在影响该广告活动。

警告

自 2023 年 2 月起，applicableRuleId 可能不完整，因为可能有多个规则同时处于有效状态（请参阅有关规则评估的详细信息），因此您应该使用 GET /sb/campaigns/{campaignId}/budgetRules 来查看广告活动的有效规则。

例如：

目前正在执行的基于规则的预算：

{
    "campaignId": 12345678901234,
    "name": "Sample Budget Rule Campaign",
    "budget": 100,
    "budgetType": "daily",
    "ruleBasedBudget": {
        "value": 110,
        "applicableRuleId": "e887669c-0f22-42fa-85ab-2ba96ea8190c",
        "applicableRuleName": "SAMPLE_BUDGET_RULE",
        "isProcessing": false
    },
    "startDate": "20200915",
    "state": "enabled",
    "bidOptimization": "false"
}

当前执行中没有基于规则的预算的广告活动，或者没有有效预算规则的广告活动：

{
     "campaignId": 12345678901234,
    "name": "Sample Budget Rule Campaign",
    "budget": 100,
    "budgetType": "daily",
    "startDate": "20200915",
    "state": "enabled",
    "bidOptimization": "false"
}