为 VOD 会话创建配置

对于 Ad Manager 集成，您需要为 VOD 会话创建广告代码。

您可能还需要根据目标平台创建 VOD 配置。Video Stitcher API 会向 Ad Manager 注册此配置。

在 Ad Manager 中创建广告代码

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

添加新的广告单元。
启用广告规则。
创建新的广告规则。执行此步骤时，请在 Ad Manager 中找到定位条件 > 广告资源部分。选择上一步中的新广告单元。
按照生成视频和音频广告代码中的步骤创建有效的广告代码，并做出以下修改：
- 选择 Google IMA SDK 作为“播放器 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 配置。继续执行本页面上的步骤。

创建 VOD 配置

如需创建配置，请使用 projects.locations.vodConfigs.create 方法。

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

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：用户定义的 VOD 配置标识符。此 ID 只能包含小写字母、数字和连字符。第一个字符必须是字母，最后一个字符必须是字母或数字，并且整个 ID 最多只能包含 63 个字符。
VOD_URI：要拼接的媒体的 URI。此 URI 必须引用 MPEG-DASH 清单 (MPD) 文件或 HLS 清单 (M3U8) 文件。使用您已为其注册 CDN 密钥的公共 URI 或未签名 URI。
注意：您可以使用 Transcoder API 创建这些清单文件。如需了解详情，请参阅根据预设创建作业。您必须公开清单文件，以便 Video Stitcher API 访问它们。
AD_TAG_URI：（将此值粘贴到下面的请求 JSON 代码块中。）从广告服务器检索到的广告元数据的网址；若要进行 Ad Manager 集成，此值必须是有效的 Ad Manager 视频广告代码。如需获取有效的广告代码，请按照上一部分在 Ad Manager 中创建广告代码中的步骤操作。
NETWORK_CODE：您的 Ad Manager 广告资源网的数字标识符；您可以在发布商帐号的 全局设置中找到该 ID

请求 JSON 正文：

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

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

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已通过运行 gcloud init 或 gcloud auth login，或使用 Cloud Shell（自动登录到 gcloud CLI）使用您的用户帐号登录了 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）

执行以下命令：

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 配置。

为媒体 CDN 设置 CDN 密钥