准备将您的客户端应用与 Google Ad Manager 配合使用

收集客户端应用所需的信息

您应提供 Google Ad Manager 创建 VOD 资产会话所需的以下信息：

字段	说明
projectNumber	用于创建启用了 Ad Manager 的会话的 Google Cloud 项目编号 (PROJECT_NUMBER)；您也可以使用项目 ID。
region	您希望 IMA SDK 用于创建 VOD 会话的位置 (LOCATION)。
vodConfigId	通过 VOD 配置 ID，用于 向 Video Stitcher API 注册 VOD 流。以下展示了完整配置资源名称的格式： projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID VOD 配置 ID 是全名的最后一部分 (VOD_CONFIG_ID). 请注意， 配置必须位于您创建 VOD 会话的位置。
networkCode	您的 Ad Manager 广告联盟的数字标识符 (NETWORK_CODE)。
oAuthToken	一个用于 具有 Video Stitcher User 角色的服务账号。请参阅生成短期有效的 OAuth 令牌。

表 1：启用了 Ad Manager 的 VOD 资产会话所需的信息

生成短期 OAuth 令牌以进行测试

如需生成与具有 Video Stitcher User 角色的服务账号关联的短期有效的 OAuth 令牌，请按以下步骤操作：

1. 将 PATH_TO_YOUR_SERVICE_KEY 替换为指向您下载到本地机器的 JSON 文件的路径。

   gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY

2. 从服务账号中检索 OAuth 2.0 不记名令牌：

   gcloud auth print-access-token

由于这是短期有效的令牌，因此您需要定期使用 gcloud auth print-access-token 命令重新生成该令牌，并将新的令牌发送到客户端应用。如需详细了解如何构建用于提供短期有效令牌的生产服务，请参阅以下部分。

重要提示：重新生成 OAuth 令牌是一项耗时操作。请尝试 在创建会话时尽可能重复使用 OAuth 令牌。您可以使用 --lifetime 标志延长令牌的有效期。

创建一项服务来向客户端应用提供信息

创建一个服务，用于提供要传递给客户端的必要信息。当应用向您的服务请求有关如何播放 VOD 资产的信息时，该服务应返回表 1 中所述的信息。

具体而言，该服务必须能够向 以安全的方式管理客户端应用使用两项服务配置此服务 账户，一个 冒充别人。 一个服务账号具有 Service Token Creator 角色，并创建一个 OAuth 为具有 Video Stitcher User 角色的服务账号创建令牌。例如：

• 服务账号 1：这是调用方服务账号。此账号对服务账号 2 拥有 Service Token Creator 权限，并向客户端应用模拟服务账号 2。
• 服务账号 2： Video Stitcher User 角色，用于创建会话。

有关从服务（包括客户端）提供 OAuth 令牌的信息 库代码示例，请参阅 创建短期有效的访问令牌。