Method: videoContent.networks.sources.content.update
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
新しいコンテンツを作成したり、コンテンツがすでにアド マネージャーに存在する場合はメタデータを更新したりするための API。成功した場合はコンテンツを返し、失敗した場合は 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/*}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
videoContent.name |
string
出力専用。動画コンテンツのリソース名。このフィールドの形式は、networks/{network_code}/sources/{content_source_id}/content/{cms_content_id} です。 network_code は、このコンテンツが属する Google アド マネージャーのネットワーク コードです。 content_source_id は、このコンテンツが属する Google アド マネージャーのコンテンツ ソース ID です。 cms_content_id は Google アド マネージャーの CMS コンテンツ ID で、該当する動画に対してアド マネージャーで配信できる広告を識別するために広告リクエストの一部として形成されます。この値は、数字または英数字です。
|
リクエスト本文
リクエストの本文には VideoContent
のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には VideoContent
のインスタンスが含まれます。
認証スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
詳しくは、OAuth 2.0 の概要をご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-21 UTC。
[null,null,["最終更新日 2025-08-21 UTC。"],[[["\u003cp\u003eThis API allows for the creation and updating of video content metadata within Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests will return the updated video content, while failures will return an error code.\u003c/p\u003e\n"],["\u003cp\u003eThe API utilizes a specific HTTP PUT request structure with path parameters to identify the target content.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary using specified OAuth scopes related to content ingestion and video ads.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can reference provided links for further information on request/response structures and authorization protocols.\u003c/p\u003e\n"]]],[],null,["# Method: videoContent.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\nAPI 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.\n\nAn example request looks like: \n\n {\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 }\n }\n }\n\n### HTTP request\n\n`PUT https://admanagervideo.googleapis.com/v1/videoContent/{videoContent.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| `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. |\n\n### Request body\n\nThe request body contains an instance of [VideoContent](/ad-manager/video/rest/v1/videoContent.networks.sources.content#VideoContent).\n\n### Response body\n\nIf successful, the response body contains an instance of [VideoContent](/ad-manager/video/rest/v1/videoContent.networks.sources.content#VideoContent).\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/contentingestion`\n- `\n https://www.googleapis.com/auth/video-ads`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]