步骤指南

​

如何获取 X Ads API 的访问权限

1. 注册开发者账户。
2. 创建开发者 App并妥善保管你的令牌。
3. 访问ads.x.com/help，为你的每个开发者 App 提交 Ads API 访问申请。

**注意：**如果你已经在 X Developer Platform 上进行开发且拥有开发者账户，请直接跳到第三步。

​

第一步：注册开发者账户

要向任一 X 的 API 产品发起请求，您必须先注册开发者账户。在开发者门户中创建一个 Project 和开发者 App。这样您将获得一组凭据，用于对所有发送至 API 的请求进行身份验证。

注册开发者账户

​

步骤二：保存你的 App 的密钥和令牌并确保其安全

在你的开发者 App 中，你将获得一组 API Key（也称为 Consumer Key）。你还可以生成一组 Access Tokens，用于代表你的个人 X 账户发起请求，以及一个 Bearer Token，用于对需要 OAuth 2.0 Bearer Token 的 endpoint 进行认证。由于这些密钥和令牌除非重新生成否则不会过期，我们建议将其配置为环境变量，或使用安全的密码管理器进行管理。

请同时记录你的 App ID，可在 App 详情页的 URL 中找到。这将使你在下一步申请访问 X Ads API 时更为便捷。

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

如果你遗失或忘记了这些密钥和令牌，你需要重新生成它们，这会创建新的密钥和令牌，并使旧的失效。这意味着你需要更新任何使用先前凭据配置的集成。

了解更多关于我们的身份验证最佳实践。

​

第三步：申请 Ads API 访问权限

此时你已拥有对 X API 的基础访问权限，但尚无法使用 X Ads API 的相关功能。接下来，你需要提交申请并通过审核以获得 Ads API 访问权限。请访问 ads.x.com/help，为你的每个开发者 App 提交 Ads API 访问申请。

​

访问层级

在申请过程中，你需要指定所需的访问级别。了解更多：App 级别和广告账户级别的权限。

​

仅限转化

可访问移动端和网页转化 endpoint，具有读写权限。

​

标准访问

提供对 Analytics、Campaign Management、Creatives、Custom Audiences 和 Conversion endpoints 的读写访问权限。

**注意：**在你的 App 获批 Ads API 访问后，你需要重新生成所有用户 access tokens，以便正确对 Ads API 请求进行身份验证。

**注意：**在 2023 年 7 月之前申请访问的 Ads API 开发者可能具有不同的访问级别和权限，并可能被限制为最多五个 OAuth 令牌。请参阅我们的提升访问级别指南，以获取更多 endpoints 的访问权限，或为现有应用解除令牌上限。

​

发起你的第一个请求

要测试你对 X Ads API 的访问权限，请向 GET accounts endpoint 发起请求。该 endpoint 将返回当前已授权用户可访问的广告账户。请在后续 API 请求中使用此请求返回的广告账户 id，以便读取和写入特定广告账户的 data。在命令行中使用 Twurl 时，请求如下所示。

示例请求

twurl -H ads-api.x.com "/11/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
     }
   ]
}

​

接下来 …

• 通读 X Ads API 文档 的基础内容，例如 版本管理 与 层级术语。
• 查看各类 X Ads API 工具与库，以助力您进行 Ads API 集成。
• 了解 提升 Ads API 访问权限 的步骤。
• 熟悉可用的 支持资源。
• 关注 @API，获取有关 API 变更、服务问题及对 X 推广产品增强的实时更新。