若要为您的项目启用 Video Stitcher API，请与您的客户代表联系或销售人员了解详情。

此页面由 Cloud Translation API 翻译。

为直播活动创建配置

对于 Ad Manager 集成，您需要为指定的直播活动创建直播配置。Video Stitcher API 会向 Ad Manager 注册此配置。

创建可选广告

在创建实际配置之前，您需要创建一个可选广告。当无法插入广告时，Video Stitcher API 会插入默认的可选视频广告。您必须通过 Video Stitcher API 注册可选广告视频，以指明要在没有广告的情况下使用的可选广告。可选视频广告可以是任何包含至少一个音轨的 MP4 文件。

您可以通过以下两种方式创建此可选广告。您可以在自己的 Ad Manager 帐号中创建默认的广告联盟可选广告，也可以使用 Video Stitcher API 创建可选广告。

在 Ad Manager 中创建可选广告

若要在您的 Ad Manager 帐号中创建默认广告联盟可选广告，请按照创建可选广告来填充内容空缺中的步骤操作，然后跳至创建实际配置部分。

使用 Video Stitcher API 创建可选广告

如需使用 Video Stitcher API 创建可选广告，请使用 projects.locations.slates.create 方法。

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

PROJECT_NUMBER：您的 Google Cloud 项目编号；位于 IAM 设置页面上的项目编号字段中
LOCATION：要在其中创建可选广告的位置；请使用支持的区域之一
显示位置信息
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
SLATE_ID：用户定义的可选广告标识符。此 ID 只能包含小写字母、数字和连字符。第一个字符必须是字母，最后一个字符必须是字母或数字，并且整个 ID 最多只能包含 63 个字符。
SLATE_URL：至少具有一个音轨的 MP4 视频的公共 URI（示例视频）
NETWORK_CODE：您的 Ad Manager 广告资源网的数字标识符；您可以在发布商帐号的 全局设置中找到该 ID
重要提示：您必须添加 gamSlate 对象，才能将可选广告与 Google Ad Manager (GAM) 搭配使用。

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

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'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "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/slates?slateId=SLATE_ID"

PowerShell (Windows)

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

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

@'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "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/slates?slateId=SLATE_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/slates/SLATE_ID",
    "verb": "create"
  },
  "done": false
}

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

查看结果

您可以使用 projects.locations.operations.get 方法检查是否已创建可选广告。如果响应包含 "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/slates/SLATE_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.Slate",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "uri": "SLATE_URL",
    "gamSlate": {
      "networkCode": "NETWORK_CODE"
      "gamSlateId": "GAM_SLATE_ID"
    }
  }
}

创建实时配置

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

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

PROJECT_NUMBER：您的 Google Cloud 项目编号；位于 IAM 设置页面上的项目编号字段中
LOCATION：要在其中创建实时配置的位置；请使用支持的区域之一
显示位置信息
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
LIVE_CONFIG_ID：用户定义的实时配置的标识符。此 ID 只能包含小写字母、数字和连字符。第一个字符必须是字母，最后一个字符必须是字母或数字，并且整个 ID 最多只能包含 63 个字符。
SOURCE_LIVESTREAM_URI：直播视频清单的来源网址。它必须可供 Video Stitcher API 访问。该网址必须可公开访问；如果为 CDN 启用了网址签名，则必须已向 Video Stitcher API 提供已注册的 CDN 密钥。如果您使用 Live Stream API 创建了测试直播，则该位置为 Cloud Storage 存储桶中 main.m3u8 或 main.mpd 文件的 URI。
AD_TAG_URI：（将此值粘贴到下面的请求 JSON 代码块中。）从广告服务器检索到的广告元数据的网址；若要进行 Ad Manager 集成，此值必须是有效的 Ad Manager 直播视频广告代码。要获取有效的广告代码，请按照生成视频和音频广告代码中的步骤进行操作，并做出以下修改：
- 对于实时路况，请启用实时路况功能。
- 对于播放器 SDK 类型，选择 Google IMA SDK。
- 将参数 ad_rule=0 添加到代码中（例如将 &ad_rule=0 添加到末尾）。
SLATE_ID：在没有拼接广告的情况下使用的可选广告的 ID
注意：如果您使用 Ad Manager 创建了默认广告联盟可选广告，请从请求中移除 defaultSlate 字段，以便使用默认广告联盟可选广告。
NETWORK_CODE：您的 Ad Manager 广告资源网的数字标识符；您可以在发布商帐号的 全局设置中找到该标识符。
AD_TRACKING：您的视频流的广告跟踪行为。对于 IMA SDK 集成，请使用 CLIENT。您也可以稍后按会话替换此值。

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

curl（Linux、macOS 或 Cloud Shell）

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

cat > request.json << 'EOF'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
EOF

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID"

PowerShell (Windows)

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

@'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
'@  | Out-File -FilePath request.json -Encoding utf8

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

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

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/liveConfigs?liveConfigId=LIVE_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/liveConfigs/LIVE_CONFIG_ID",
    "verb": "create"
  },
  "done": false
}

Video Stitcher API 会在您的 Ad Manager 帐号中异步注册配置。这可能需要几分钟的时间。

此命令会创建一个长时间运行的操作 (LRO)，您可以通过查询该操作来跟踪进度。如需了解详情，请参阅检查结果。

获取配置

如需获取配置，请使用 projects.locations.liveConfigs.get 方法。

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

PROJECT_NUMBER：您的 Google Cloud 项目编号；位于 IAM 设置页面上的项目编号字段中
LOCATION：实时配置的位置；请使用支持的区域之一
显示位置信息
- us-central1
- us-east1
- us-west1
- asia-east1
- asia-south1
- asia-southeast1
- europe-west1
- southamerica-east1
LIVE_CONFIG_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/liveConfigs/LIVE_CONFIG_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/liveConfigs/LIVE_CONFIG_ID" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
    "assetKey": "ASSET_KEY",
    "customAssetKey": "PROJECT_NUMBER-LOCATION-LIVE_CONFIG_ID"
  },
  "state": "READY",
  "adTracking": "CLIENT",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "stitchingPolicy": "CUT_CURRENT"
}

找到 customAssetKey 字段并复制返回的 CUSTOM_ASSET_KEY。您将在后续步骤中将这些值发送到互动式媒体广告 (IMA) SDK。