Method: videoContent.networks.sources.content.update

API 来创建新内容或更新其元数据(如果内容已经存在于 Ad Manager 中)。成功时返回内容,失败时返回 google.rpc.Code

示例请求如下所示:

{
   "status": "ACTIVE",
   "title": "Best video ever",
   "updateTime": "2019-01-24T01:30:15.01Z",
   "duration": "230s",
   "cuePoints": ["55.532s", "192s"],
   "publishTime": "2019-01-24T01:30:15.01Z",
   "thumbnailUrl": "http://www.domain.com/tn.jpg",
   "metadata": {
       "keyValues": {
           "category": "sports",
           "tag": ["soccer", "messi"],
       }
   }
}

HTTP 请求

PUT https://admanagervideo.googleapis.com/v1/videoContent/{videoContent.name=networks/*/sources/*/content/*}

网址采用 gRPC 转码语法。

路径参数

参数
videoContent.name

string

仅限输出。视频内容的资源名称。此字段的格式为:networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}

network_code 是此内容所属的 Google Ad Manager 中的广告联盟代码。

content_source_id 是此内容在 Google Ad Manager 中所属的内容来源 ID。

cms_content_id 是 Google Ad Manager 中的 CMS 内容 ID,作为广告请求的一部分,用于确定 Ad Manager 可以针对相应的视频投放哪些广告。此值可以是数字或字母数字。

请求正文

请求正文包含一个 VideoContent 实例。

响应正文

如果成功,则响应正文包含一个 VideoContent 实例。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/contentingestion
  • https://www.googleapis.com/auth/video-ads

如需了解详情,请参阅 OAuth 2.0 概览