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

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

您需要提供 使用 Google Ad Manager 创建直播活动:

字段说明
projectNumber用于创建启用了 Ad Manager 的会话的 Google Cloud 项目编号 (PROJECT_NUMBER);您也可以使用项目 ID。
region 注册实时配置的位置 (LOCATION)。
liveConfigId通过 用于 通过 Video Stitcher API 注册直播活动。以下展示了完整配置资源名称的格式:
projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID
配置 ID 是全名 (LIVE_CONFIG_ID) 的最后部分。请注意,配置的位置必须与创建会话的位置相同。
customAssetKey在直播配置注册期间创建的自定义素材资源键 (CUSTOM_ASSET_KEY);IMA SDK 需要此值才能创建数据流。
networkCode您的 Ad Manager 广告联盟的数字标识符 (NETWORK_CODE)。
oAuthToken一个用于 具有 Video Stitcher User 角色的服务账号。请参阅 生成短期有效的 OAuth 令牌

表 1:启用了 Ad Manager 的直播会话所需的信息

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

要生成 短期有效的 OAuth 令牌 与 具有 Video Stitcher User 角色的服务账号,请遵循 具体步骤:

  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 命令,并将新的 向您的客户端应用添加令牌。如需详细了解如何构建用于提供短期有效令牌的生产服务,请参阅以下部分。

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

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

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

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

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