用途:管理限定在已配置广告账户范围内的 Spotify Ads 受众。
主要能力:列出或获取受众及数据集,支持分页与按 audience_types、audience_ids、q 过滤;展示受众类型、子类型、来源、状态、规模区间、受众类别(若返回)与 ID。上传客户名单需先请求签名上传 URL,再用 GCS 可续传流程两步上传(POST 初始化取会话 URI,PUT 上传文件),随后创建受众。也可创建网页事件受众(指定 dataset_ids、included_events、excluded_events、lookback_days)或广告互动受众(campaign_ids 或 ad_set_ids、exposure_type 为 IMPRESSIONS/CLICKS、lookback_days 为 30/60/90/180)。相似受众通过 seed_audience_id 创建。编辑用 PATCH,仅支持 name 和 description 且必须带 audience_type;删除用 DELETE。
使用方式:先读取 api-reference 中的 live-openapi.md;通过脚本 api-request.sh 调用 api GET/POST/PATCH/DELETE。需要原始上传 curl 时执行 eval $(api --env) 获取 TOKEN、AD_ACCOUNT_ID、BASE_URL、SDK_HEADER、SKILL_HEADER,并在调用中保留 -H "$SDK_HEADER" 与 -H "$SKILL_HEADER"。
限制与防护:绝不显示、记录、汇总或持久化客户名单内容;不声称受众重叠估算(无该端点);不支持任意批量上传,须逐个文件处理并确认文件名与受众名映射。状态为异步(PROCESSING、LEARNING、BOOKABLE、LIVE 等),不承诺完成时间;客户名单受众达到 BOOKABLE 才可定向,处理最多三天;LIVE 受众被广告组使用,需解除依赖才能删除。仅在网络错误或 5xx 时重试 GET,绝不自动重试 POST、PATCH、PUT、DELETE。解析前检查 HTTP_STATUS,非超时 4xx 展示 API 错误且不重试。