为 VOD 会话创建配置

对于 Ad Manager 集成，您需要为 VOD 会话创建广告代码。您还需要创建一个 VOD 配置。Video Stitcher API 会将此配置注册到 Ad Manager。

在 Ad Manager 中创建广告代码

在您的 Ad Manager 账号中执行以下步骤：

1. 添加新广告单元。
2. 启用广告规则。

3. 创建新的广告规则。 在此步骤中，请在 Ad Manager 中找到定位 > 广告资源部分。选择上一步中创建的新广告单元。

4. 按照生成视频和音频广告代码中的步骤创建有效的广告代码，并进行以下修改：

   • 对于播放器 SDK 类型，请选择 Google IMA SDK。
   • 将参数 ad_rule=1 添加到代码中（例如，将 &ad_rule=1 添加到末尾）。
   • 将参数 vid_d=vod-asset-duration-in-secs 添加到标记中（例如，对于 30 分钟的 VOD 资产，请在末尾添加 &vid_d=1800）。
   • 将参数 output=vast 修改为 output=xml_vmap1。视频多广告播放列表 (VMAP) 规范是唯一支持的输出类型。

创建 VOD 配置

注意 ：如果您的目标平台是 Chromecast 上的 IMA SDK，请勿创建 VOD 配置。跳过以下步骤。

如需创建配置，请使用 projects.locations.vodConfigs.create 方法。如需了解可选字段（例如自定义标头），请参阅 VOD 配置参考文档。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_NUMBER：您的 Google Cloud 项目编号；此值位于IAM 设置页面上的项目编号字段中
• LOCATION：创建视频点播配置的位置；请使用某个受支持的区域
  显示位置
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• VOD_CONFIG_ID：用户定义的视频点播配置标识符。 此 ID 只能包含小写字母、数字和连字符。第一个字符必须是字母，最后一个字符必须是字母或数字，整个 ID 不得超过 63 个字符。
• VOD_URI：要拼接的媒体的 URI。此 URI 必须引用 MPEG-DASH 清单 (MPD) 文件或 HLS 清单 (M3U8) 文件。使用您注册了 CDN 密钥的公开 URI 或未签名的 URI。
  注意：您可以使用 Transcoder API 创建这些清单文件。如需了解详情，请参阅创建 VOD 源文件。您必须将清单文件设为公开，以便 Video Stitcher API 可以访问它们。
• AD_TAG_URI

  从广告服务器检索的广告元数据的网址；对于 Ad Manager 集成，此网址必须是有效的 Ad Manager 视频广告代码。如需获取有效的广告代码，请按照上一部分中的在 Ad Manager 中创建广告代码部分中的步骤操作。
• NETWORK_CODE：您的 Ad Manager 广告资源网的数字标识符；您可以在发布商账号的 全局设置中找到此标识符

请求 JSON 正文：

{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

cat > request.json << 'EOF'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}
EOF

然后，执行以下命令以发送 REST 请求：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs?vodConfigId=VOD_CONFIG_ID"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

@'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

然后，执行以下命令以发送 REST 请求：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs?vodConfigId=VOD_CONFIG_ID" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "done": false
}

此命令会创建一个长时间运行的操作 (LRO)，您可以对其进行查询以跟踪进度。复制返回的 OPERATION_ID（即 name 字段的最后一部分），以便在下一部分中使用。

检查结果

使用 projects.locations.operations.get 方法检查是否已创建 VOD 配置。如果响应包含 "done: false"，请重复该命令，直到响应包含 "done: true"。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_NUMBER：您的 Google Cloud 项目编号；此值位于IAM 设置页面上的项目编号字段中
• LOCATION：数据的位置；请使用某个受支持的地区
  显示位置
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• OPERATION_ID：操作的标识符

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "endTime": END_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.VodConfig",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "sourceUri": "VOD_URI",
    "adTagUri": "AD_TAG_URI",
    "gamVodConfig": {
      "networkCode": "NETWORK_CODE"
    },
    "state": "READY"
  }
}

检查状态是否设置为 READY。如果没有，请等待几秒钟，然后重新发送请求。

如需详细了解 VOD 配置，请参阅创建和管理 VOD 配置。