已验证用户访问权限

GET accounts/:account_id/authenticated_user_access

检索当前已验证用户 (access_token) 的权限,这些权限与指定的广告账号相关。此类权限与 ads.twitter.com 上公开的权限相匹配。

可能值包含:

  • ACCOUNT_ADMIN:拥有可修改广告活动和查看统计数据的完全访问权限,包含添加或删除用户以及更改设置的权限
  • AD_MANAGER:拥有可修改广告活动和查看统计数据的完全访问权限,但不能添加或删除用户或者更改设置
  • CREATIVE_MANAGER:拥有可修改素材和查看预览的访问权限,但无权创建或修改广告活动
  • CAMPAIGN_ANALYST:拥有可查看广告活动和查看统计数据的访问权限,但无权创建或修改广告活动
  • ANALYST(ads.twitter.com 上的“Organic Analyst”):拥有可查看原始分析和受众洞察的访问权限,但无权创建、修改或查看广告活动
  • PARTNER_AUDIENCE_MANAGER:仅 API 访问权限可以查看和修改数据合作伙伴受众,但无法访问广告活动、素材或其他受众类型。

此外,TWEET_COMPOSER 权限表示已验证用户可以代表广告商创建 cast 为空(或“仅用于推广”)的推文。这仅适用于拥有 ACCOUNT_ADMINAD_MANAGERCREATIVE_MANAGER 访问权限的用户。

资源 URL

https://ads-api.twitter.com/10/accounts/:account_id/authenticated_user_access

参数

请求示例

GET https://ads-api.twitter.com/10/accounts/18ce54d4x5t/authenticated_user_access

响应示例

{
  "data": {
    "user_id": 2417045708,
    "permissions": [
      "ACCOUNT_ADMIN",
      "TWEET_COMPOSER"
    ]
  },
  "request": {
    "params": {
      "account_id": "18ce54d4x5t"
    }
  }
}