巨量千川（一对多）对接指南

2026-7-8 17:17| 发布者: 万红刚| 查看: 14| 评论: 0

摘要: 巨量千川（一对多）对接指南本文用于指导您在观远数据连接器中创建“巨量千川（一对多）”数据账户，并完成账号授权。“一对多”模式适用于同一授权关系下需要按具体千川投放账户拉取数据的场景，因此除账户名称和授 ...

本文用于指导您在观远数据连接器中创建“巨量千川（一对多）”数据账户，并完成账号授权。“一对多”模式适用于同一授权关系下需要按具体千川投放账户拉取数据的场景，因此除账户名称和授权外，还需要填写 qianchuan_account_id。

1. 适用范围

本指南适用于需要同步巨量千川广告投放、账户、计划、报表等数据，并且需要在观远侧明确指定某个千川投放账户 ID 的客户。

巨量引擎商业开放平台的授权机制采用 OAuth 2.0。官方说明中，应用在获得客户授权并获取 Access Token 后，才能通过接口访问对应客户的数据。观远连接器会在您点击授权并完成平台确认后维护后续接口调用所需的授权信息。

请先确认您可以正常登录巨量引擎商业开放平台或巨量引擎工作台，并且当前登录账号对目标巨量千川账户拥有授权权限。若授权页中看不到目标账户，请先在巨量引擎侧确认账号、组织、店铺或广告账户权限。

请准备需要同步数据的千川投放账户 ID，并在观远字段 qianchuan_account_id 中填写。巨量引擎官方接口文档中，千川投放账户相关接口会使用投放账户 ID 作为账户维度参数；在观远一对多模式中，该字段用于明确当前数据账户绑定哪一个千川投放账户。

如果不确定账户 ID，可在巨量千川或巨量引擎后台查看目标投放账户信息，也可以由客户侧投放管理员提供。请只填写数字 ID，不要填写账户名称、店铺名称或授权用户名。

字段	获取位置	用途
账户名称	客户自定义	用于观远侧区分数据账户，建议使用品牌、店铺或投放账户简称。
qianchuan_account_id	巨量千川或巨量引擎后台的千川投放账户 ID	用于指定当前数据账户要拉取的千川投放账户。
巨量千川账号授权	点击“立即授权”后在巨量引擎官方授权页完成	用于授予观远连接器访问目标账户数据的权限。

在观远连接器中进入数据账户管理，点击新增数据账户，在所属平台中选择“巨量千川（一对多）”。

观远连接器新增巨量千川一对多数据账户

在“账户名称”中填写便于识别的名称。在 qianchuan_account_id 中填写目标千川投放账户 ID。该字段为必填项，填写错误会导致授权后任务无法定位到正确账户，或接口请求返回无权限、账户不存在等错误。

点击“立即授权”。系统会跳转到巨量引擎授权页面，请使用具备目标千川投放账户权限的账号登录，并在授权页选择或确认需要授权给观远的数据范围和账户。

授权过程中请注意：

授权成功后返回观远数据账户页面，确认授权状态变为已完成，再点击“确定”保存数据账户。保存后即可在连接器中选择该数据账户创建或运行巨量千川相关数据任务。

第三方平台字段或信息	观远连接器字段或动作	是否必填	说明
千川投放账户 ID	qianchuan_account_id	是	填写目标千川投放账户的数字 ID，用于一对多模式下定位具体账户。
客户自定义识别名称	账户名称	是	用于观远侧数据账户管理和区分。
巨量千川账号权限	立即授权	是	在巨量引擎官方授权页完成确认，连接器据此获取后续接口访问权限。
Access Token / Refresh Token	授权结果	否	授权成功后由连接器维护，不需要客户手动填写。

问题	处理建议
不知道 qianchuan_account_id 填什么	请在巨量千川或巨量引擎后台查看目标千川投放账户 ID，或联系客户侧投放管理员提供。不要填写账户名称或店铺名称。
授权成功但任务提示账户无权限	核对 `qianchuan_account_id` 是否属于本次授权账号可操作的千川投放账户；如果不是，请更换 ID 或重新授权正确账号。
点击授权后无法看到目标账户	确认当前登录的巨量引擎账号是否拥有目标千川投放账户、店铺或组织权限；必要时切换账号或联系管理员。
需要同步多个千川投放账户	建议分别创建多个“巨量千川（一对多）”数据账户，每个数据账户填写对应的 `qianchuan_account_id` 并完成授权。
授权后页面仍显示未完成	确认是否已经在巨量引擎授权页点击确认，并等待页面自动返回观远；如果浏览器拦截了跳转，请重新发起授权。