巨量千川M-API实战：5分钟搞定短视频计划数据自动获取（Python版）
最近和几个做电商的朋友聊天，他们都在抱怨同一个问题：每天要花大量时间登录巨量千川后台，手动导出各个短视频计划的投放数据，然后汇总到Excel里做分析。这个过程不仅枯燥重复，还容易出错，尤其是当账户下计划数量多的时候，简直是一场噩梦。他们问我，有没有办法让这个过程自动化，最好能定时跑，数据直接进数据库或者生成报表。这让我想起了之前用巨量千川的M-API（Marketing API）做过的一些数据整合项目。对于有一定Python基础的开发者或技术型运营来说，利用M-API搭建一个轻量级的自动化数据拉取工具，其实并没有想象中那么复杂。关键在于理清授权流程、理解数据接口的调用逻辑，以及处理好一些高频出现的“坑”，比如token刷新、账户ID的获取路径等。这篇文章，我就从一个实战编码的角度，带你一步步拆解这个过程，分享可直接复用的代码片段和我的踩坑经验，目标是让你在理解原理的基础上，快速搭建起属于自己的数据自动化管道。
1. 环境准备与核心概念梳理
在开始写代码之前，我们需要先确保开发环境就绪，并理解几个关键概念。这能避免你在后续步骤中因为环境问题或概念混淆而卡住。
首先，你需要一个Python环境。我推荐使用Python 3.8或以上版本，兼容性和稳定性都更好。必不可少的库是 requests，用于发送HTTP请求。如果你习惯用虚拟环境管理依赖，可以先创建一个：
python -m venv venv
# Windows
venv\\Scripts\\activate
# macOS/Linux
source venv/bin/activate
然后安装核心库：
pip install requests pandas
这里我加上了 pandas，虽然不是获取数据的必需项，但在后续处理和分析返回的JSON数据时，它会非常方便。
接下来，我们得在巨量引擎开放平台完成前置工作。这包括创建应用、获取关键凭证以及理解授权流程。很多开发者第一步就卡在这里，其实流程很清晰：
注意：access_token 的有效期通常为24小时，而 refresh_token 的有效期更长（如30天）。这意味着你的自动化脚本必须具备自动刷新 access_token 的能力，否则每天都会中断。
为了更清晰地对比这几个核心凭证的用途和生命周期，我整理了下表：
| APP_ID & App Secret | 平台创建应用后获得 | 应用身份标识，用于所有API认证的起点 | 永久（除非重置） | 否 |
| auth_code | 用户授权后，从回调URL参数中获取 | 用于初次换取 access_token 和 refresh_token | 极短（通常几分钟） | 否 |
| access_token | 使用 auth_code 或 refresh_token 调用API换取 | 调用具体业务API（如查询计划数据）的令牌 | 约24小时 | 是，通过 refresh_token |
| refresh_token | 随 access_token 一同返回 | 在 access_token 过期前，用于刷新获取新的 access_token | 约30天 | 是，刷新后会得到新的 refresh_token |
理清了这些，我们的代码逻辑主干就出来了：获取初始授权 -> 换取并存储token -> 定时刷新token -> 使用有效的token调用数据接口。
2. 构建稳健的Token管理模块
Token是整个自动化流程的“钥匙”，管理不好，一切免谈。这一节，我们重点构建一个能够自动处理token获取、刷新和存储的模块。很多开源示例代码把token直接写在脚本里，这是非常不安全的，也不利于自动化。
首先，我们创建一个配置文件（比如 config.py）来存放敏感信息和常量，避免硬编码：
# config.py
APP_ID = \’你的应用APP_ID\’
APP_SECRET = \’你的应用App Secret\’
# 初次手动授权后获得的auth_code，仅使用一次
INITIAL_AUTH_CODE = \’初次获取的auth_code\’
# API请求的基础地址
BASE_API_URL = \’https://ad.oceanengine.com/open_api/\’
接下来，我们实现token的获取与刷新函数。我将它们封装在一个类里，这样状态管理会更清晰：
# token_manager.py
import requests
import json
import time
from config import APP_ID, APP_SECRET, BASE_API_URL
class TokenManager:
def __init__(self, token_file=\’token_data.json\’):
self.app_id = APP_ID
self.secret = APP_SECRET
sel
