REST Resource: videoContent.networks.sources.content

משאב: VideoContent

המטא-נתונים של התוכן.

ייצוג JSON
{
  "name": string,
  "status": enum (VideoContentStatus),
  "title": string,
  "updateTime": string,
  "publishTime": string,
  "duration": string,
  "cuePoints": [
    string
  ],
  "thumbnailUrl": string,
  "metadata": {
    object (Metadata)
  },
  "gracenoteMetadata": {
    object (GracenoteMetadata)
  },
  "syndicationMetadata": {
    object (VideoContentSyndicationInfo)
  },
  "dynamicAdInsertionMetadata": {
    object (DynamicAdInsertionInfo)
  }
}
שדות
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 כנגד הסרטון המתאים. הערך הזה יכול להיות מספרי או אלפאנומרי.

status

enum (VideoContentStatus)

סטטוס התוכן. אם לא תציינו ערך, ערך ברירת המחדל יהיה פעיל.

title

string

חובה. כותרת התוכן.

updateTime

string (Timestamp format)

חובה. מועד השינוי האחרון של התוכן.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

publishTime

string (Timestamp format)

מועד הפרסום של התוכן. זהו שדה חובה, אם הסרטון נועד להיכלל בכללי מודעות המציינים שעת התחלה ושעת סיום.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

duration

string (Duration format)

משך הזמן של התוכן. משך הזמן נתמך עד לרמה של אלפית השנייה.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

cuePoints[]

string (Duration format)

מזהה את נקודות הסימון. נקודות סימון הן מקומות בזמן שבהם ניתן להוסיף מודעה לסרטון. יש תמיכה בנקודות סימון עד לרמה של אלפית השנייה. זהו שדה חובה אם הסרטון כולל הפסקות למודעות באמצע סרטון.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

thumbnailUrl

string

כתובת ה-URL של התוכן בתמונה ממוזערת.

metadata

object (Metadata)

מזהה את המטא-נתונים המותאמים אישית של התוכן.

gracenoteMetadata

object (GracenoteMetadata)

מטא-נתונים של התוכן שקשורים ל-Gracenote.

syndicationMetadata

object (VideoContentSyndicationInfo)

מטא-נתונים של התוכן שקשורים להפצה.

dynamicAdInsertionMetadata

object (DynamicAdInsertionInfo)

מטא-נתונים של התוכן שקשורים להטמעת מודעות דינמיות.

VideoContentStatus

אפשרויות סטטוס להצגה או אי-הצגה של מודעות מטורגטות בתוכן מסוים.

טיפוסים בני מנייה (enum)
ACTIVE יוצגו מודעות שמטורגטות לפי תוכן.
BLOCKED לא יוצגו מודעות בתוכן זה אם הסטטוס הוא 'חסום'.
DELETED התוכן יועבר לארכיון ב-Ad Manager. אם מערכת Ad Manager מקבלת בקשה להצגת מודעה בתוכן שסומן כ'נמחק', עדיין ניתן יהיה להציג מודעות בית או מודעות שמטורגטות ליחידות מלאי או לקריטריוני טירגוט אחרים. כדי לחסום מודעות, צריך להגדיר את הסטטוס 'חסום'.

מטא-נתונים

מטא-נתונים מותאמים אישית של התוכן.

ייצוג JSON
{
  "keyValues": {
    string: value,
    ...
  }
}
שדות
keyValues

map (key: string, value: value (Value format))

מזהה את המטא-נתונים המותאמים אישית של התוכן כצמד מפתח/ערך. אפשר להשתמש רק במחרוזות או ברשימת מחרוזות בשביל ערכים.

GracenoteMetadata

המטא-נתונים של Gracenote של התוכן.

ייצוג JSON
{
  "gracenoteId": string,
  "gracenoteSeriesId": string
}
שדות
gracenoteId

string

חובה. מתייחס למזהה Gracenote של התוכן. היא חייבת לכלול את אחת מהקידומות החוקיות הבאות: 1. 'EP' - פרק מסדרה 2. MV - סרט 3. 'SP' - אירוע ספורט

gracenoteSeriesId

string

זה שינוי אופציונלי. השדה הזה מתייחס למזהה הסדרה ב-Gracenote. התחילית של הכתובת חייבת להיות 'SH'.

VideoContentSyndicationInfo

המטא-נתונים לציון קשרים בין תוכן קנוני לבין תוכן בסינדיקציה.

ייצוג JSON
{

  // Union field syndication can be only one of the following:
  "canonicalVideoContent": string,
  "syndicatedVideoContentNames": {
    object (SyndicatedVideoContentNames)
  }
  // End of list of possible types for union field syndication.
}
שדות
שדה איחוד syndication. VideoContentSyndiationMetadata יכול להכיל רק אחד מהערכים הבאים. syndication יכול להיות רק אחת מהאפשרויות הבאות:
canonicalVideoContent

string

שם התוכן הקנוני חייב להיות בפורמט הבא: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' וחייב להיות שייכים לאותה רשת כמו התוכן המכיל את השדה הזה.

syndicatedVideoContentNames

object (SyndicatedVideoContentNames)

אוסף של תוכן בסינדיקציה

SyndicatedVideoContentNames

רשימת השמות של כל התוכן שבהפצה.

ייצוג JSON
{
  "syndicatedVideoContent": [
    string
  ]
}
שדות
syndicatedVideoContent[]

string

שדה חוזר של שם התוכן שבהפצה. הן צריכות להיות בפורמט: 'networks/{network_code}/sources/{content_source_id}/content/{cms_content_id}' וחייב להיות שייכים לאותה רשת כמו התוכן המכיל את השדה הזה.

DynamicAdInsertionInfo

מידע שקשור להטמעת מודעות דינמיות.

ייצוג JSON
{
  "videoIngestUrlInfo": {
    object (VideoIngestUrlInfo)
  },
  "mediaUpdateTime": string,
  "closedCaptionUrlInfo": [
    {
      object (ClosedCaptionUrlInfo)
    }
  ],
  "fwCaid": string
}
שדות
videoIngestUrlInfo

object (VideoIngestUrlInfo)

קישור לקובץ ה-m3u8 הראשי שמשמש ליצירת התאמות וליצירת פלייליסטים.

mediaUpdateTime

string (Timestamp format)

המועד שבו בוצע השינוי האחרון של קובץ הסרטון שאליו מתבצעת הפניה ב-videoIngestUrlInfo.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

closedCaptionUrlInfo[]

object (ClosedCaptionUrlInfo)

כתובת ה-URL לקובץ הכתוביות.

fwCaid

string

מזהה נכס מותאם אישית של Freewheel המשמש לטירגוט מודעות.

VideoIngestUrlInfo

מטא-נתונים שמציינים את הקישור לקובץ m3u8 המשמש ליצירת תנאי וליצירת פלייליסטים.

ייצוג JSON
{
  "videoFormat": enum (VideoFormat),
  "videoPreconditioned": enum (VideoPreconditioned),
  "url": string
}
שדות
videoFormat

enum (VideoFormat)

הפורמט של הסרטון.

videoPreconditioned

enum (VideoPreconditioned)

כדי לציין אם התוכן כבר הוגדר להצגת מודעות באמצע סרטון (mid-roll), כלומר הפלחים כבר מפוצלים בזמן ההפסקות למודעות.

url

string

הקישור לקובץ m3u8.

VideoFormat

הפורמטים שבהם תוכן וידאו יכול להיות מקודד.

טיפוסים בני מנייה (enum)
VIDEO_FORMAT_UNSPECIFIED פורמט הסרטון לא צוין.
HLS application/x-mpegURL
DASH application/dash+xml

VideoPreconditioned

המצב המותנה של תוכן הסרטון.

טיפוסים בני מנייה (enum)
NO עדיין לא מותנה.
YES הסרטון עבר תנאי/פוצל.

ClosedCaptionUrlInfo

מטא-נתונים של קובץ כתוביות אחד.

ייצוג JSON
{
  "languageCode": string,
  "closedCaptionFormat": enum (ClosedCaptionFormat),
  "url": string
}
שדות
languageCode

string

קוד השפה IETF BCP-47 שמייצג את השפה שבה נמצא קובץ הכתוביות.

closedCaptionFormat

enum (ClosedCaptionFormat)

הפורמט של קובץ הכתוביות.

url

string

כתובת ה-URL לקובץ הכתוביות.

ClosedCaptionFormat

הפורמטים שבהם יכולים להיות קובצי הכתוביות.

טיפוסים בני מנייה (enum)
CLOSED_CAPTION_FORMAT_UNSPECIFIED הפורמט של הכתוביות הסגורות לא צוין.
TTML application/ttaf+xml
WEB_VTT text/vtt

שיטות

update

API ליצירת תוכן חדש או לעדכון המטא-נתונים שלו אם התוכן כבר קיים ב-Ad Manager.