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 |
פלט בלבד. שם המשאב של תוכן הסרטון. הפורמט של השדה הזה הוא: '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.