为 VOD 会话创建配置

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

在 Ad Manager 中创建广告代码

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

添加新的广告单元。
启用广告规则。
创建新的广告规则。在此步骤中，请在 Ad Manager 中找到定位 > 广告资源部分。选择上一步中创建的新广告单元。
按照生成视频和音频广告代码并做如下修改：
- 对于播放器 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 配置

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

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

PROJECT_NUMBER：您的 Google Cloud 项目编号；此值位于 IAM 设置页面上的项目编号字段中
LOCATION：要在其中创建 VOD 配置的位置；请使用某个受支持的区域
显示位置
- 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) 文件。使用公开 URI 或注册了 CDN 密钥。
注意：您可以使用 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) 您可以查询该 ID 以跟踪进度。复制返回的 OPERATION_ID（即 name 字段的最后一部分），以便在下一部分中使用。

检查结果

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