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/*}
URL ใช้ไวยากรณ์การแปลง 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 ที่ควรมีเนื้อหานี้ cms_content_id คือรหัสเนื้อหา CMS ใน Google Ad Manager ซึ่งเป็นส่วนหนึ่งของคำขอโฆษณาเพื่อระบุว่า Ad Manager จะแสดงโฆษณารายการใดให้กับวิดีโอที่เกี่ยวข้องได้ ค่านี้จะเป็นตัวเลขหรือตัวอักษรและตัวเลขคละกันก็ได้
|
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ 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)."]]
