Method: videoContent.networks.sources.content.update

  • This API is used to create new video content or update its metadata within Ad Manager.

  • The API uses a PUT request to a specific URL format that includes the network code, content source ID, and CMS content ID.

  • The request body should contain an instance of VideoContent, while the response body will return a VideoContent instance upon success or an error code on failure.

  • Authorization for this API requires either the contentingestion or video-ads OAuth scopes.

API to create new content or update its metadata if the content already exists in Ad Manager. Returns the content on success or a google.rpc.Code on failure.

An example request looks like:

{
   "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 request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
videoContent.name

string

Output only. The resource name of the video content. This field has the format of: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}'

network_code is the network code in Google Ad Manager to which this content belongs.

content_source_id is the content source ID in Google Ad Manager to which this content should belong.

cms_content_id is the CMS content ID in Google Ad Manager, formed as a part of the ad request to identify which ads Ad Manager can serve against the corresponding video. This value can be numeric or alphanumeric.

Request body

The request body contains an instance of VideoContent.

Response body

If successful, the response body contains an instance of VideoContent.

Authorization Scopes

Requires one of the following OAuth scopes:

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

For more information, see the OAuth 2.0 Overview.