入门指南

如何访问广告 API

  1. 注册一个开发者账号
  2. 创建开发者应用并妥善保管令牌
  3. 请求广告 API 访问权限

注意:  如果你已在 Twitter 开发者平台上进行构建,并且拥有开发者账号,请跳至步骤 3。

步骤 1:注册一个开发者账号

要请求访问 Twitter 的任何 API 产品,必须先注册一个开发者账号。在开发者门户中,创建一个项目和开发者应用。这将提供一组凭据,这些凭据可用于来验证对 API 的所有请求。


步骤 2:保存应用的密钥和令牌并妥善保管

在开发者应用中,你将获得一组 API 密钥(也称为使用者密钥)。还可生成一组可用于代表你的 Twitter 个人账号发出请求的访问令牌,以及一个可用于对需要 OAuth 2.0 不记名令牌的端点进行验证的不记名令牌。这些密钥和令牌不会过期(除非重新生成),因此建议你创建环境变量或使用安全的密码管理器。

另外请记下应用 ID,它位于应用详细信息的 URL 中。在下一步中,这可帮助你更轻松地请求广告 API 的访问权限。

请注意:密钥和令牌在开发者门户中只显示一次,因此生成这些凭据后,请务必立即将它们存储在你的密码管理系统中。

如果放错位置或忘记了密钥和令牌,则需要重新生成它们,这会创建新的密钥和令牌,并使旧的密钥和令牌失效。这意味着你将不得不更新使用先前的凭据设置的所有集成。在 2021 年 1 月之前,你可以通过开发者门户检索应用的密钥和令牌。

详细了解我们的身份证最佳实践。 

步骤 3:申请广告 API 的访问权限

此时,你将拥有对 Twitter API 的基本访问权限,但没有特定 Twitter 广告 API 功能的访问权限。接下来,你需要请求访问权限并获得批准。

访问层

首先,你将获得广告 API 的“受限”访问权限,初始限制是只有 5 位 Twitter 用户可使用你的应用。这时,你的应用可向广告 API 发出请求。 在开发与广告 API 的集成时,建议调高令牌上限。如需了解如何调高这些上限,请查看提升访问权限指南

受限

初级受限许可为企业提供可访问广告 API 端点的权限,使他们能够完成自己工具的开发。受限级访问权限的开发者应用初始限制为 5 个 OAuth 令牌。

高级

下一级别。高级访问权限表示开发者已通过实际的试验性广告活动来证明自己的概念。开发者应用的 OAuth 令牌上限已调高,支持业务扩展。

发出第一个请求

要测试你对广告 API 的访问权限,请向 GET 账号端点发出请求。该端点将返回当前授权用户有权访问的广告账号。在后续的 API 请求中,可使用此请求中的广告账号 ID 来读取和写入特定广告账号的数据。如果在命令行中使用 Twurl,请求将如下所示。

示例请求

      twurl -H ads-api.twitter.com "/10/accounts"
    

示例响应

      {
  "request": {
    "params": {}
  },
  "data": {
    "name": "Furni",
    "business_name": null,
    "timezone": "America/Los_Angeles",
    "timezone_switch_at": "2016-04-06T07:00:00Z",
    "id": "18ce54ayf0z",
    "created_at": "2016-04-07T14:40:15Z",
    "salt": "b88939e5cabbca720159cb3659d73c06",
    "updated_at": "2017-02-08T08:49:53Z",
    "business_id": null,
    "approval_status": "ACCEPTED",
    "deleted": false
  }
}
    

 

后续操作…