# 开始使用广告服务统一平台公共 API

> 设置组织、服务帐户和 API 密钥，以便开始使用 广告服务 Unified Platform public API 以编程方式管理您的应用、广告位或广告系列。

广告服务 Unified Platform public API 是 Unity Monetization（变现）和 Unity User Acquisition（用户获取）后台的最新版本的管理 API（旧版）。

如果已在 Unity Monetization 或 User Acquisition（用户获取）后台中使用管理 API（旧版），请参阅改用广告服务统一平台公共 API [迁移到新 Unity](/monetization/performance-and-analytics/api/manage-api/migrate-to-the-new-dashboard-manage-api.md) Dashboard。

虽然您可以直接在 Unity Dashboards 中管理您的应用、广告位和广告系列，但广告服务统一平台公共 API 允许您以编程方式管理终端。下表详细介绍了可以使用 API 管理的终端：

| **后台** | **托管终端**                                                         | **优点**                                                       |
| ------ | ---------------------------------------------------------------- | ------------------------------------------------------------ |
| 变现     | * 应用程序
* 广告位
* 测试设备                                              | 批量创建和更新广告位，而不是一时间一个。如果您定期启动新应用、添加广告位或跨不同广告格式调整测试设备，这些终端非常有用。 |
| 用户获取   | - 应用程序
- 归因
- Campaigns（广告系列）
- 广告系列管理
- 广告素材包
- Creatives（广告素材） | 自动执行更改，而不是在控制面板中一时间执行一个更改。如果您管理大量广告系列或需要频繁更新，这些终端非常有用。       |

要开始使用广告服务统一平台公共 API，请完成以下设置任务：

1. 先决条件
2. 创建组织
3. 创建服务帐户
4. 生成 API 密钥y
5. 实现广告服务统一平台公共 API

1) **Prerequisites**

   在开始使用广告服务统一平台公共 API 之前，请确保团队中的某个人在 Unity 后台中具有以下组织角色：

   | **后台** | **必需角色** |
   | ------ | -------- |
   | 变现     | 所有者      |
   | 用户获取   | 经理       |

2) **Create an organization**

   创建一个组织以便在广告服务统一平台公共 API 中管理您的终端。

   请参阅[创建组织](/cloud/organizations/create-organization.md)以进行设置，并参阅其他[组织](/cloud/organizations.md)文章以在创建组织后管理或更新组织。

3) **Create a service account**

   从 [New Unity Dashboard](https://cloud.unity.com/) 创建服务帐户以验证 API 调用。

   ### Advertisers

   要从 User Acquisition（用户获取）后台创建服务帐户并为其添加广告主指定的角色，请完成以下步骤：

   1.转到 User Acquisition（用户获取）后台 > **设置** > **组织** > **管理组织** > **服务帐户** > **+ 新建**。
   2.选择 **+ 管理组织角色**。
   3.输入服务帐户名称和服务帐户描述。
   4.在创建的新服务帐户页面中，转到 **Organization roles** 部分 > **+ Manage organization roles**。
   5.从 Organization roles 对话框中，转到 **Grow** 下拉选单，然后选择列表中的所有 Advertise API 角色以添加到服务帐户。

   ### Publishers

   要从 Monetization（变现）后台创建服务帐户并为其添加发布者指定的角色，请完成以下步骤：

   1.转到 Monetization（变现）后台 > **设置** > **组织** > **管理组织** > **服务帐户** > **+ 新建**。
   2.选择 **+ 管理组织角色**。
   3.输入服务帐户名称和服务帐户描述。
   4.在创建的新服务帐户页面中，转到 **Organization roles 部分** > **+ Manage organization roles**。
   5.从 Organization roles 对话框中，转到 Monetization 下拉选单，然后选择以下 Publisher API 角色以添加到您的服务帐户：

   * **广告服务发布者自动化**
   * **广告服务商测试设备自动化**

4) **Generate your API key**

   要创建 API 密钥来验证 Unity Dashboard 的请求，请从新服务帐户执行以下操作：

   1.转到服务帐户的 **Keys** 部分。
   2.选择 **+ 添加密钥** 以创建 API 密钥。

   > **Important:**
   >
   > 后台仅显示一次密钥，因此请将 Key ID 和 Secret 安全地存储在一起，供以后参考。如果丢失了键值，则必须创建新键。

   3.选择 **Done**。

5) **Implement the Ads Unified Platform public API**

   请参阅以下 API 参考以构建集成。

   * 发布者：[广告服务统一平台发布者公共 API](/oas-unified-platform-publisher-public/1.0.0.md)
   * 广告主：[广告服务统一平台广告主公共 API](/oas-unified-platform-advertiser-public/1.0.0.md)