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 הוא מזהה התוכן של מערכת ניהול התוכן ב-Google Ad Manager, שנוצר כחלק מהבקשה להצגת מודעה. הוא נוצר כחלק מהבקשה להצגת מודעה, כדי לזהות אילו מודעות ניתן להציג ב-Ad Manager כנגד הסרטון המתאים. הערך הזה יכול להיות מספרי או אלפאנומרי.
|
גוף הבקשה
גוף הבקשה מכיל מופע של 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 (שעון 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)."]]
