- משאב: VideoContent
- VideoContentStatus
- מטא-נתונים
- GracenoteMetadata
- VideoContentSyndicationInfo
- SyndicatedVideoContentNames
- DynamicAdInsertionInfo
- VideoIngestUrlInfo
- VideoFormat
- VideoPreconditioned
- ClosedCaptionUrlInfo
- ClosedCaptionFormat
- שיטות
משאב: VideoContent
המטא-נתונים של התוכן.
ייצוג JSON |
---|
{ "name": string, "status": enum ( |
שדות | |
---|---|
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 כנגד הסרטון המתאים. הערך הזה יכול להיות מספרי או אלפאנומרי. |
status |
סטטוס התוכן. אם לא תציינו ערך, ערך ברירת המחדל יהיה פעיל. |
title |
חובה. כותרת התוכן. |
updateTime |
חובה. מועד השינוי האחרון של התוכן. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
publishTime |
מועד הפרסום של התוכן. זהו שדה חובה, אם הסרטון נועד להיכלל בכללי מודעות המציינים שעת התחלה ושעת סיום. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
duration |
משך הזמן של התוכן. משך הזמן נתמך עד לרמה של אלפית השנייה. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
cuePoints[] |
מזהה את נקודות הסימון. נקודות סימון הן מקומות בזמן שבהם ניתן להוסיף מודעה לסרטון. יש תמיכה בנקודות סימון עד לרמה של אלפית השנייה. זהו שדה חובה אם הסרטון כולל הפסקות למודעות באמצע סרטון. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
thumbnailUrl |
כתובת ה-URL של התוכן בתמונה ממוזערת. |
metadata |
מזהה את המטא-נתונים המותאמים אישית של התוכן. |
gracenoteMetadata |
מטא-נתונים של התוכן שקשורים ל-Gracenote. |
syndicationMetadata |
מטא-נתונים של התוכן שקשורים להפצה. |
dynamicAdInsertionMetadata |
מטא-נתונים של התוכן שקשורים להטמעת מודעות דינמיות. |
VideoContentStatus
אפשרויות סטטוס להצגה או אי-הצגה של מודעות מטורגטות בתוכן מסוים.
טיפוסים בני מנייה (enum) | |
---|---|
ACTIVE |
יוצגו מודעות שמטורגטות לפי תוכן. |
BLOCKED |
לא יוצגו מודעות בתוכן זה אם הסטטוס הוא 'חסום'. |
DELETED |
התוכן יועבר לארכיון ב-Ad Manager. אם מערכת Ad Manager מקבלת בקשה להצגת מודעה בתוכן שסומן כ'נמחק', עדיין ניתן יהיה להציג מודעות בית או מודעות שמטורגטות ליחידות מלאי או לקריטריוני טירגוט אחרים. כדי לחסום מודעות, צריך להגדיר את הסטטוס 'חסום'. |
מטא-נתונים
מטא-נתונים מותאמים אישית של התוכן.
ייצוג JSON |
---|
{ "keyValues": { string: value, ... } } |
שדות | |
---|---|
keyValues |
מזהה את המטא-נתונים המותאמים אישית של התוכן כצמד מפתח/ערך. אפשר להשתמש רק במחרוזות או ברשימת מחרוזות בשביל ערכים. |
GracenoteMetadata
המטא-נתונים של Gracenote של התוכן.
ייצוג JSON |
---|
{ "gracenoteId": string, "gracenoteSeriesId": string } |
שדות | |
---|---|
gracenoteId |
חובה. מתייחס למזהה Gracenote של התוכן. היא חייבת לכלול את אחת מהקידומות החוקיות הבאות: 1. 'EP' - פרק מסדרה 2. MV - סרט 3. 'SP' - אירוע ספורט |
gracenoteSeriesId |
זה שינוי אופציונלי. השדה הזה מתייחס למזהה הסדרה ב-Gracenote. התחילית של הכתובת חייבת להיות 'SH'. |
VideoContentSyndicationInfo
המטא-נתונים לציון קשרים בין תוכן קנוני לבין תוכן בסינדיקציה.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד syndication . VideoContentSyndiationMetadata יכול להכיל רק אחד מהערכים הבאים. syndication יכול להיות רק אחת מהאפשרויות הבאות: |
|
canonicalVideoContent |
שם התוכן הקנוני חייב להיות בפורמט הבא: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' וחייב להיות שייכים לאותה רשת כמו התוכן המכיל את השדה הזה. |
syndicatedVideoContentNames |
אוסף של תוכן בסינדיקציה |
SyndicatedVideoContentNames
רשימת השמות של כל התוכן שבהפצה.
ייצוג JSON |
---|
{ "syndicatedVideoContent": [ string ] } |
שדות | |
---|---|
syndicatedVideoContent[] |
שדה חוזר של שם התוכן שבהפצה. הן צריכות להיות בפורמט: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' וחייב להיות שייכים לאותה רשת כמו התוכן המכיל את השדה הזה. |
DynamicAdInsertionInfo
מידע שקשור להטמעת מודעות דינמיות.
ייצוג JSON |
---|
{ "videoIngestUrlInfo": { object ( |
שדות | |
---|---|
videoIngestUrlInfo |
קישור לקובץ ה-m3u8 הראשי שמשמש ליצירת התאמות וליצירת פלייליסטים. |
mediaUpdateTime |
המועד שבו בוצע השינוי האחרון של קובץ הסרטון שאליו מתבצעת הפניה ב-videoIngestUrlInfo. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
closedCaptionUrlInfo[] |
כתובת ה-URL לקובץ הכתוביות. |
fwCaid |
מזהה נכס מותאם אישית של Freewheel המשמש לטירגוט מודעות. |
VideoIngestUrlInfo
מטא-נתונים שמציינים את הקישור לקובץ m3u8 המשמש ליצירת תנאי וליצירת פלייליסטים.
ייצוג JSON |
---|
{ "videoFormat": enum ( |
שדות | |
---|---|
videoFormat |
הפורמט של הסרטון. |
videoPreconditioned |
כדי לציין אם התוכן כבר הוגדר להצגת מודעות באמצע סרטון (mid-roll), כלומר הפלחים כבר מפוצלים בזמן ההפסקות למודעות. |
url |
הקישור לקובץ m3u8. |
VideoFormat
הפורמטים שבהם תוכן וידאו יכול להיות מקודד.
טיפוסים בני מנייה (enum) | |
---|---|
VIDEO_FORMAT_UNSPECIFIED |
פורמט הסרטון לא צוין. |
HLS |
application/x-mpegURL |
DASH |
application/dash+xml |
VideoPreconditioned
המצב המותנה של תוכן הסרטון.
טיפוסים בני מנייה (enum) | |
---|---|
NO |
עדיין לא מותנה. |
YES |
הסרטון עבר תנאי/פוצל. |
ClosedCaptionUrlInfo
מטא-נתונים של קובץ כתוביות אחד.
ייצוג JSON |
---|
{
"languageCode": string,
"closedCaptionFormat": enum ( |
שדות | |
---|---|
languageCode |
קוד השפה IETF BCP-47 שמייצג את השפה שבה נמצא קובץ הכתוביות. |
closedCaptionFormat |
הפורמט של קובץ הכתוביות. |
url |
כתובת ה-URL לקובץ הכתוביות. |
ClosedCaptionFormat
הפורמטים שבהם יכולים להיות קובצי הכתוביות.
טיפוסים בני מנייה (enum) | |
---|---|
CLOSED_CAPTION_FORMAT_UNSPECIFIED |
הפורמט של הכתוביות הסגורות לא צוין. |
TTML |
application/ttaf+xml |
WEB_VTT |
text/vtt |
שיטות |
|
---|---|
|
API ליצירת תוכן חדש או לעדכון המטא-נתונים שלו אם התוכן כבר קיים ב-Ad Manager. |