（即将废弃）获取投放中旧版 Smart+ 推广系列的动态配额

您可以使用本接口获取广告账户投放中的 Smart+ 推广系列的动态配额。

重要提示
- 升级版 Smart+ API： - 我们正在升级 Smart+ API，以提供优化的功能和性能。新的升级版 Smart+ API 已上线。了解升级版 Smart+ 推广系列和可用的升级版 Smart+ API 接口。 - 快速开始： - 报表：无需额外的白名单。 - 推广系列管理：如需获取升级版 Smart+ 体验的权限，请联系你的 TikTok 销售代表，将您的广告账户加入白名单。如果你的广告账户已在白名单中，即可直接使用升级版 Smart+ API 的创建和修改接口。 - 旧版 API 弃用： - 自 2026 年 3 月 31 号，您将无法再通过 /campaign/spc/create/ 接口创建旧版 Smart+ 推广系列。 - 请注意，未迁移的旧版 Smart+ 推广系列不会自动迁移到新版 API。此后若尝试使用旧版 Smart+ API 接口将导致报错，并且无法通过此接口新建推广系列。 - 对于已接入旧版 API 客户的弃用延期申请流程： - 1. 提交申请：若您需要延期使用旧版 Smart+ API 创建接口，请通过旧版 Smart+ 接口下线延期申请表单提交申请。 - 2. 白名单处理：收到申请后，我们将为您的开发者应用 ID 处理白名单准入。提交延长申请表单的开发者可继续调用 /campaign/spc/create/ 接口至 2026 年 6 月 30 日。 - 3. 特殊情况申请：若您有强烈的业务需求，需要在 2026 年 6 月 30 日后继续使用该接口，请直接在表单中说明具体情况，或者与您的销售代表单独联系。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/campaign/spc/quota/get/

方法 GET

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
| advertiser_id {必填} | string | 广告主 ID。 |

示例

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/campaign/spc/quota/get/?advertiser_id={{advertiser_id}}' \
--header 'Access-token: {{Access-token}}'
(/code)

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述，参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志 ID，唯一标识一个请求。 |
|data |object| 返回数据。 |
#|total_quota|number|广告账户的投放中 Smart+ 推广系列总配额。|
#|used_quota|number|广告账户的投放中 Smart+ 推广系列已使用的配额。|
#|used_campaign_ids|string[]|仅当 `used_quota` 大于 0 时返回本字段。<br><br>广告账户中已创建的投放中 Smart+ 推广系列的 ID 列表。<br><br>若想暂停投放中的 Smart+ 推广系列，可使用 [/campaign/status/update/](1739320994354178.html) 并将 `operation_status` 设置为 `DISABLE`。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "active_campaign_ids": [
            "{{active_campaign_id}}",
            "{{active_campaign_id}}"
        ],
        "total_quota": 50,
        "used_quota": 2
    }
}
(/code)