访问广告账号

用户账号对比广告账号

使用广告 API 涉及两种类型的账号：广告账号和 Twitter 用户账号。在广告 API 文档中，“账号”术语通常是指广告账号。

  • 广告账号是在 ads.twitter.com 上注册的，在 API 中由 account_id 标识。广告账号直接链接到资金来源并利用作为“可推广用户”的一个或多个 Twitter 用户账号的内容。每个广告账号均可将权限授予给一个或多个 Twitter 用户账号。广告账号或“当前账号”在几乎每个执行的 URL 中表示为内嵌 account_id 参数。
  • Twitter 用户账号（如 @AdsAPI）由广告 API 中的 user_id 标识。一个或多个此类账号可与广告账号关联。通过该 API 发出请求的已验证 Twitter 用户账号称为“当前用户”。 可通过 GET accounts 获取当前用户具有访问权限的广告账号列表。“可推广用户”是特定广告账号可以推广的 Twitter 用户名。有关这方面的更多详细信息，请参阅获取广告账号访问权限。
 

广告账号访问方法

你可以通过两种方法向广告商的账号发出广告 API 请求：

  1. 代表广告商发出请求（推荐）
  2. 使用已获得广告商账号（例如支持多个账号的代理商）的访问权限的账号发出请求。

本文档简要概述了这些选项之间的区别，应与我们的其他资源一起使用，例如多用户登陆常见问题。 

如授权一个请求中所述，向广告 API 发出的全部请求，均需要使用 OAuth 1.0a 的 Authorization 标题，并包含通过三方 OAuth 流获得的访问令牌。你的应用程序需要实施一个基于网站的 OAuth 流，以获取访问令牌。广告 API 开发者不得要求我们的 Twitter 广告商分享其登录凭据。

默认情况下，各 Twitter 开发者应用程序均包含一个静态访问令牌，用于为拥有该应用程序的账号发出广告 API 请求。这些证书十分适合单账号的使用情景，无需要求三方或基于 PIN 的 OAuth 流。如果你不访问其他 Twitter 广告账号，请使用这些单用户证书，可以不必遵守以下步骤。

访问级別

有权访问广告账号的各个用户均拥有特定的账号级许可： 账号管理员、广告经理、广告活动分析师、有机分析师和素材经理；请参见 business.twitter.com，了解有关账号级许可的最新文件。应用程序应当通过授权用户访问 API 端点检索当前已验证用户的许可，以确定用户可访问哪些 API 端点和广告功能。

获取访问令牌的方法

1.获取广告商（用户）的访问令牌

有两种方法获取广告商的访问令牌。最常见的方式是直接从你的网站用户界面上通过三方 OAuth 流 来获取。如果应用程序没有可供广告商公开访问的用户界面，可以实施基于 PIN 的 Oauth 进程。用户完成三方授权流之后，你的应用程序将获得通过 API 为广告账号发出请求的证书。

我们强烈建议大多数广告 API 开发者通过 OAuth 流获取用户证书，以此来获取广告商账号访问权限。它允许你代表用户调用 API 并代表该用户执行操作。这些令牌不会过期，但用户随时都可撤销它们。

2.获取你（开发者）的访问令牌

此选项要求广告商授权你的 @username（或 @usernames）通过 ads.twitter.com 的 Twitter 用户界面访问他们的 Twitter 广告账号。通过三方 OAuth 流为你的账号取得的访问令牌将能够访问广告商的 Twitter 广告账号。

这允许你使用自己的 @username 的 OAuth 令牌，而非广告商的 OAuth 令牌调用该 API。此选项的主要特点是，如果已向你的 @username 授予推文委托/撰写工具许可，则你将仅可创建纯推广推文。

要获取访问权限并在该账号上代表可推广用户创建纯推广推文，你还必须在此流中获得授予用于创建推文的访问权限。FULL这将允许通过 GET accounts/:account_id/authenticated_user_access 端点上的TWEET_COMPOSER许可获得访问权限。

这些方法之间的不同

  广告商（用户）OAuth 令牌
（开发者）OAuth 令牌
 （添加到单独账号的 @username）
访问广告账号 ✔ ✔
代表用户创建推文 ✔ ✔*
管理广告活动 ✔ ✔
访问分析 ✔ ✔
代表用户创建卡片 ✔ ✔
开发者访问的能力
通过 Twitter 广告用户界面		   ✔
速率限制 因广告商而异 因广告商账号而异

* 见上述获取你（开发者）的访问令牌章节，了解更多详细信息。

用例示例

广告商通过 OAuth 三方网站流访问令牌

标准流是基于网站的流，使用三方授权 OAuth 流。下述屏幕截图是示例的部分内容，你可在以下位置查看其源代码：https://github.com/twitterdev/twauth-web。

在应用程序中的某个时刻，你将希望重定向至 Twitter，以便授权你的应用程序 image0 使用请求令牌重定向到 Twitter 时，将会提示用户授权你的应用程序 image1 授权你的应用程序后，用户将重定向至你生成请求令牌时提供的回调 URL。你将用其获取此用户的永久访问令牌，并将此令牌存储在本地 image2