获取已授权账户
此接口用于获取AccessToken下已经授权的账户列表,获取到的账户可根据账户类型结合其他接口文档,确认其他接口支持账户类型范围。
- 重新授权会覆盖前一次授权,需要确保此次授权已经勾选了想要的全部账户
- 账号与账户管理关系发生变更,同步会影响到AccessToken下授权账户关系
请求地址
https://api.oceanengine.com/open_api/oauth2/advertiser/get/可视化调试SDK下载MCP调用
请求方法
GET
请求参数
字段
类型
描述
access_token
string
根据授权auth_code获取生成的AccessToken
授权页面使用相同账号授权对应同一个AccessToken,如使用多个不同的账号授权,则需要区分维护多个不同的AccessToken
请求示例
应答字段
字段
类型
描述
code
number
返回码,详见 【附录-返回码】
message
string
返回信息,详见 【附录-返回码】
data
json
json返回值
list
object[]
账户信息
advertiser_id
number
账户ID
advertiser_name
string
账户名称
account_role
string
账户类型,枚举值:
ADVERTISER客户CUSTOMER_ADMIN普通版工作台-管理员CUSTOMER_OPERATOR普通版工作台-协作者AGENT代理商CHILD_AGENT二级代理商PLATFORM_ROLE_STAR星图账户PLATFORM_ROLE_SHOP_ACCOUNT抖音店铺账户PLATFORM_ROLE_QIANCHUAN_AGENT千川代理商PLATFORM_ROLE_STAR_AGENT星图代理商PLATFORM_ROLE_AWEME抖音号PLATFORM_ROLE_STAR_MCN星图MCN机构PLATFORM_ROLE_STAR_ISV星图服务商AGENT_SYSTEM_ACCOUNT代理商系统账户PLATFORM_ROLE_LOCAL_AGENT本地推代理商PLATFORM_ROLE_YUNTU_BRAND_ISV_ADMIN云图品牌服务商管理员PLATFORM_ROLE_LIFE抖音来客账户PLATFORM_ROLE_ENTERPRISE_BP_ADMIN升级版工作台管理员PLATFORM_ROLE_ENTERPRISE_BP_OPERATOR升级版工作台协作者
is_valid
bool
授权有效性
注意:false则表示账号与账户已无管理关系,无权限继续操作使用,需在对应账户所属业务平台重新调整管理关系
company_list
object[]
代理商账户下授权公司范围,仅当授权页面授权代理商账户时有效
- company_list为空则代表当前代理商账户下所有adv均可访问
- company_list不为空则代表仅能访问列表内部分客户下业务账户
customer_company_id
number
客户公司ID
customer_company_name
string
客户公司名称
account_string_id
string
账户ID,仅当account_role=PLATFORM_ROLE_AWEME抖音号时有效,即为aweme_sec_uid,可用于Dou+接口调用
request_id
string
请求日志id

