收集客户端应用所需的信息
您应具备 Google Ad Manager 创建直播会话所需的以下信息:
字段 | 说明 |
---|---|
projectNumber | 用于创建启用了 Ad Manager 的会话的 Google Cloud 项目编号 (PROJECT_NUMBER );您也可以使用项目 ID。 |
region |
注册实时配置的位置 (LOCATION )。
|
liveConfigId | 用于向 Video Stitcher API 注册直播活动的实时配置 ID。以下展示了完整配置资源名称的格式:projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID LIVE_CONFIG_ID ) 的最后部分。请注意,配置的位置必须与创建会话的位置相同。
|
customAssetKey | 在直播配置注册期间创建的自定义素材资源键 (CUSTOM_ASSET_KEY );IMA SDK 需要此值才能创建数据流。 |
networkCode | 您的 Ad Manager 广告联盟的数字标识符 (NETWORK_CODE )。 |
oAuthToken | 具有 Video Stitcher User 角色的服务账号的短期有效 OAuth 令牌。请参阅生成短期有效的 OAuth 令牌。 |
表 1:启用了 Ad Manager 的直播会话所需的信息
生成短期 OAuth 令牌以进行测试
如需生成与具有 Video Stitcher User 角色的服务账号关联的短期有效的 OAuth 令牌,请按以下步骤操作:
- 将
PATH_TO_YOUR_SERVICE_KEY
替换为指向您下载到本地机器的 JSON 文件的路径。gcloud auth activate-service-account --key-file PATH_TO_YOUR_SERVICE_KEY
- 从服务账号检索 OAuth 2.0 不记名令牌:
gcloud auth print-access-token
由于这是短期有效的令牌,因此您需要定期使用 gcloud auth print-access-token
命令重新生成该令牌,并将新令牌发送到客户端应用。如需详细了解如何构建用于提供短期有效令牌的生产服务,请参阅以下部分。
创建一个服务以向客户端应用提供信息
创建一个服务,用于提供要传递给客户端的必要信息。当应用向您的服务请求有关如何播放直播的信息时,服务应返回表 1 中所述的信息。
特别是,该服务必须能够以安全的方式向客户端应用提供 OAuth 令牌。使用两个服务账号配置此服务,其中一个账号冒充另一个账号。一个服务账号具有 Service Token Creator 角色,并为具有 Video Stitcher User 角色的服务账号创建 OAuth 令牌。例如:
- 服务账号 1:这是调用方服务账号。此账号对服务账号 2 拥有 Service Token Creator 权限,并向客户端应用模拟服务账号 2。
- 服务账号 2:这是具有特权的服务账号,具有用于创建会话的 Video Stitcher User 角色。
如需了解如何从您的服务提供 OAuth 令牌(包括客户端库代码示例),请参阅创建短期有效的访问令牌。