Method: videoContent.networks.sources.content.update
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
واجهة برمجة التطبيقات لإنشاء محتوى جديد أو تعديل بياناته الوصفية إذا كان المحتوى متوفرًا في "مدير إعلانات Google". عرض المحتوى عند التعذُّر أو 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" الذي ينتمي إليه هذا المحتوى. content_source_id هو معرّف مصدر المحتوى في "مدير إعلانات Google" الذي يجب أن ينتمي إليه هذا المحتوى. cms_content_id هو Content ID لنظام إدارة المحتوى (CMS) في "مدير إعلانات Google"، وقد تمّ تكوينه كجزء من طلب الإعلان لتحديد الإعلانات التي يمكن أن يعرضها "مدير الإعلانات" على الفيديو المقابل لها. يمكن أن تكون هذه القيمة رقمية أو أبجدية رقمية.
|
نص الطلب
يحتوي نص الطلب على مثال VideoContent.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال VideoContent.
نطاقات التفويض
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/contentingestion
https://www.googleapis.com/auth/video-ads
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)."]]
