Method: updateWithLinking.networks.sources.content.update
Stay organized with collections
Save and categorize content based on your preferences.
API to create new content or update the 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:
{
"videoContent": {
"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"],
"views": 700000,
"rating": 5.5,
}
}
},
"linkInfo": {"parentContentId": "parent-content-id-1"}
}
HTTP request
PUT https://contentingestion.googleapis.com/v1/updateWithLinking/{name=networks/*/sources/*/content/*}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
name |
string
The resource name of the video content. VideoContent names have the form 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' The network code in Google Ad Manager to which this content belongs. The content source ID in Google Ad Manager to which this content should belong. The CMS content ID in Ad Manager, this is a required request parameter, formed as a part of the ad request to identify which ads Ad Manager can serve against the corresponding video. This value will be used for the vid parameter on a video ad request. It can be numeric or alphanumeric.
|
Request body
The request body contains an instance of VideoContentWithLinking
.
Response body
If successful, the response body contains an instance of VideoContentWithLinking
.
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/contentingestion
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThe API is used to create or update video content metadata in Google Ad Manager and returns the content or an error code.\u003c/p\u003e\n"],["\u003cp\u003eThe API uses a PUT request with a specific URL structure including network, source, and content IDs.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain video metadata like title, duration, cue points, and thumbnail URL, formatted as specified in the example.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses return the updated video content data, while errors are indicated by a specific code.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/contentingestion\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This API updates content metadata in Ad Manager via a `PUT` request to a specific URL, structured using gRPC Transcoding. The request includes `name` as a path parameter, defining the content's network, source, and CMS ID. The request and response bodies use `VideoContentWithLinking` instances, demonstrated in an example, which include details like status, title, duration, and custom metadata. Successful updates return the updated content; failures return error codes. It is required the OAuth scope `https://www.googleapis.com/auth/contentingestion`.\n"],null,["# Method: updateWithLinking.networks.sources.content.update\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\n| Deprecated: new clients should use the AdManager Video API: \u003chttps://developers.google.com/ad-manager/video\u003e.\nAPI to create new content or update the metadata if the content already exists in Ad Manager. Returns the content on success or a `google.rpc.Code` on failure.\n\nAn example request looks like: \n\n {\n \"videoContent\": {\n \"status\": \"ACTIVE\",\n \"title\": \"Best video ever\",\n \"updateTime\": \"2019-01-24T01:30:15.01Z\",\n \"duration\": \"230s\",\n \"cuePoints\": [\"55.532s\", \"192s\"],\n \"publishTime\": \"2019-01-24T01:30:15.01Z\",\n \"thumbnailUrl\": \"http://www.domain.com/tn.jpg\",\n \"metadata\": {\n \"keyValues\": {\n \"category\": \"sports\",\n \"tag\": [\"soccer\", \"messi\"],\n \"views\": 700000,\n \"rating\": 5.5,\n }\n }\n },\n \"linkInfo\": {\"parentContentId\": \"parent-content-id-1\"}\n }\n\n`\n``\n`\n\n### HTTP request\n\n`PUT https://contentingestion.googleapis.com/v1/updateWithLinking/{name=networks/*/sources/*/content/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` The resource name of the video content. VideoContent names have the form 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' The network code in Google Ad Manager to which this content belongs. The content source ID in Google Ad Manager to which this content should belong. The CMS content ID in Ad Manager, this is a required request parameter, formed as a part of the ad request to identify which ads Ad Manager can serve against the corresponding video. This value will be used for the vid parameter on a video ad request. It can be numeric or alphanumeric. |\n\n### Request body\n\nThe request body contains an instance of [VideoContentWithLinking](/ad-manager/content-ingestion/rest/v1/updateWithLinking.networks.sources.content#VideoContentWithLinking).\n\n### Response body\n\nIf successful, the response body contains an instance of [VideoContentWithLinking](/ad-manager/content-ingestion/rest/v1/updateWithLinking.networks.sources.content#VideoContentWithLinking).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/contentingestion`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n`\n``\n\n\n`"]]