Videos

משאב video מייצג סרטון ב-YouTube.

Methods

ה-API תומך בשיטות הבאות למשאבי videos:

getRating
אחזור הדירוגים שהמשתמש המורשה נתן לרשימה של סרטונים ספציפיים. כדאי לנסות עכשיו.
list
הפונקציה מחזירה רשימה של סרטונים שתואמים לפרמטרים של בקשת ה-API. כדאי לנסות עכשיו.
batchGetStats
מאחזר רשימה של נתונים סטטיסטיים של סרטונים שתואמים לפרמטרים של בקשת ה-API. כדאי לנסות עכשיו.
הוספה
העלאת סרטון ל-YouTube והגדרת המטא-נתונים של הסרטון (אופציונלי).
update
עדכון המטא-נתונים של סרטון. כדאי לנסות עכשיו.
מחיקה
מחיקת סרטון ב-YouTube. כדאי לנסות עכשיו.
rate
להוסיף לסרטון דירוג לייק או דיסלייק, או להסיר דירוג מסרטון. כדאי לנסות עכשיו.
reportAbuse
דיווח על סרטון שמכיל תוכן פוגעני. כדאי לנסות עכשיו.

ייצוג מקורות מידע

מבנה ה-JSON הבא מציג את הפורמט של משאב videos:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

מאפיינים

בטבלה הבאה מוגדרים המאפיינים שמופיעים במשאב הזה:

מאפיינים
kind string
מזהה את סוג המשאב של ה-API. הערך יהיה youtube#video.
etag etag
ה-Etag של המשאב הזה.
id string
המזהה שבו YouTube משתמש כדי לזהות את הסרטון באופן ייחודי.
snippet object
אובייקט snippet מכיל פרטים בסיסיים על הסרטון, כמו השם, התיאור והקטגוריה שלו.
snippet.publishedAt datetime
התאריך והשעה שבהם הסרטון פורסם. יכול להיות שהשעה הזו תהיה שונה מהשעה שבה הסרטון הועלה. לדוגמה, אם סרטון הועלה כסרטון פרטי ואחר כך הפך לגלוי לכולם, המאפיין הזה יציין את השעה שבה הסרטון הפך לגלוי לכולם.

יש כמה מקרים מיוחדים:
  • אם סרטון מועלה כסרטון פרטי ובעל הערוץ מאחזר את המטא-נתונים של הסרטון, ערך המאפיין מציין את התאריך והשעה שבהם הסרטון הועלה.
  • אם סרטון מועלה כסרטון לא רשום, ערך המאפיין מציין גם את התאריך והשעה שבהם הסרטון הועלה. במקרה כזה, כל מי שמכיר את מזהה הסרטון הייחודי יכול לאחזר את המטא-נתונים של הסרטון.
  • אם סרטון הועלה כסרטון בלעדי למועדון, ערך המאפיין מציין את התאריך והשעה שבהם הסרטון הועלה.
הערך מצוין בפורמט ISO 8601.
snippet.channelId string
המזהה הייחודי ש-YouTube משתמשת בו כדי לזהות את הערוץ שאליו הועלה הסרטון. הערך הזה יכול להשתנות עם הזמן, למשל כשסרטון מוקצה מחדש לערוץ אחר (לדוגמה, ערוץ נושא או ערוץ אומן).
snippet.title string
שם הסרטון. אורך הערך של המאפיין הזה יכול להיות עד 100 תווים, והוא יכול לכלול את כל התווים התקפים בקידוד UTF-8, למעט < ו->. צריך להגדיר ערך למאפיין הזה אם קוראים למתודה videos.update ומעדכנים את החלק snippet במשאב video.
snippet.description string
תיאור הסרטון. אורך הערך של המאפיין יכול להיות עד 5,000 בייטים, והוא יכול להכיל את כל תווי UTF-8 התקפים, למעט < ו->.

אפשר ליצור פרקים בסרטון על ידי הוספת חותמות זמן מעוצבות (לדוגמה, 00:00) לתיאור הסרטון.
snippet.thumbnails object
מפה של תמונות ממוזערות שמשויכות לסרטון. לכל אובייקט במפה, המפתח הוא השם של התמונה הממוזערת, והערך הוא אובייקט שמכיל מידע אחר על התמונה הממוזערת.
snippet.thumbnails.(key) object
ערכי המפתחות התקינים הם:
  • ‫default – התמונה הממוזערת שמוגדרת כברירת מחדל. תמונת ברירת המחדל של סרטון – או של מקור שמפנה לסרטון, כמו פריט בפלייליסט או תוצאת חיפוש – היא ברוחב של 120 פיקסלים ובגובה של 90 פיקסלים. תמונת ברירת המחדל של הערוץ היא ברוחב 88 פיקסלים ובגובה 88 פיקסלים.
  • medium – גרסה ברזולוציה גבוהה יותר של התמונה הממוזערת. בסרטון (או במשאב שמפנה לסרטון), התמונה הזו היא ברוחב 320 פיקסלים ובגובה 180 פיקסלים. התמונה של הערוץ היא ברוחב 240 פיקסלים ובגובה 240 פיקסלים.
  • high – גרסה ברזולוציה גבוהה של התמונה הממוזערת. בסרטון (או במשאב שמפנה לסרטון), התמונה הזו היא ברוחב 480 פיקסלים ובגובה 360 פיקסלים. בערוץ, התמונה הזו היא ברוחב 800 פיקסלים ובגובה 800 פיקסלים.
  • ‫standard – גרסה של התמונה הממוזערת ברזולוציה גבוהה יותר מזו של high. התמונה הזו זמינה לחלק מהסרטונים ולמשאבים אחרים שמתייחסים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. הרוחב של התמונה הזו הוא 640 פיקסלים והגובה שלה הוא 480 פיקסלים.
  • maxres – גרסה ברזולוציה גבוהה של התמונה הממוזערת. גודל התמונה הזה זמין לחלק מהסרטונים ולמקורות מידע אחרים שמתייחסים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. התמונה הזו היא ברוחב 1,280 פיקסלים ובגובה 720 פיקסלים.
  • fhd – גרסת Full HD (‏1080p) של התמונה הממוזערת. גודל התמונה הזה זמין בחלק מהסרטונים. התמונה הזו היא ברוחב 1,920 פיקסלים ובגובה 1,080 פיקסלים.
  • ‫qhd – גרסת Quad HD‏ (1440p / 2K) של התמונה הממוזערת. גודל התמונה הזה זמין בחלק מהסרטונים. התמונה הזו היא ברוחב 2,560 פיקסלים ובגובה 1,440 פיקסלים.
  • ‫uhd – הגרסה ברזולוציה גבוהה במיוחד (4K) של התמונה הממוזערת. גודל התמונה הזה זמין בחלק מהסרטונים. התמונה הזו היא ברוחב 3,840 פיקסלים ובגובה 2,160 פיקסלים.
snippet.thumbnails.(key).url string
כתובת ה-URL של התמונה.
snippet.thumbnails.(key).width unsigned integer
רוחב התמונה.
snippet.thumbnails.(key).height unsigned integer
גובה התמונה.
snippet.channelTitle string
שם הערוץ שאליו משויך הסרטון.
snippet.tags[] list
רשימה של תגי מילות מפתח שמשויכים לסרטון. התגים יכולים להכיל רווחים. האורך המקסימלי של ערך המאפיין הוא 500 תווים. חשוב לשים לב לכללים הבאים לגבי אופן החישוב של מגבלת התווים:
  • ערך המאפיין הוא רשימה, והפסיקים בין הפריטים ברשימה נספרים במסגרת המגבלה.
  • אם תג מכיל רווח, שרת ה-API מתייחס לערך התג כאילו הוא מוקף במירכאות, והמירכאות נספרות במגבלת התווים. לכן, לצורך מגבלות התווים, התג Foo-Baz מכיל שבעה תווים, אבל התג Foo Baz מכיל תשעה תווים.
snippet.categoryId string
קטגוריית הסרטון ב-YouTube שאליה משויך הסרטון. אם קוראים לשיטה videos.update ומעדכנים את החלק snippet במשאב video, צריך להגדיר ערך למאפיין הזה.
snippet.liveBroadcastContent string

מציין אם הסרטון הוא שידור חי פעיל או שידור חי שיתחיל בקרוב. הערך שלו הוא none אם הסרטון הוא לא שידור חי פעיל או שידור חי שיתחיל בקרוב.



הערכים התקינים של המאפיין הזה הם:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
השפה של הטקסט במאפיינים snippet.title ו-snippet.description של המשאב video.
snippet.localized object
אובייקט snippet.localized מכיל שם ותיאור של הסרטון בשפה המקומית, או את השם בשפת ברירת המחדל של מטא-נתוני הסרטון.
  • אם בבקשת videos.list נעשה שימוש בפרמטר hl כדי לציין שפה שבה צריך להחזיר טקסט מותאם לשוק המקומי ויש טקסט מותאם לשוק המקומי בשפה הזו, הטקסט המותאם לשוק המקומי מוחזר בקטע הקוד של המשאב.
  • המטא-נתונים של שפת ברירת המחדל מוחזרים אם לא צוין ערך לפרמטר hl או אם צוין ערך אבל אין מטא-נתונים מתורגמים לשפה שצוינה.
המאפיין מכיל ערך לקריאה בלבד. משתמשים באובייקט localizations כדי להוסיף, לעדכן או למחוק כותרות מותאמות לשפה.
snippet.localized.title string
שם הסרטון המותאם לשוק המקומי.
snippet.localized.description string
תיאור הסרטון שמותאם לשוק המקומי.
snippet.defaultAudioLanguage string
המאפיין default_audio_language מציין את השפה המדוברת בטראק האודיו שמוגדר כברירת מחדל בסרטון.
contentDetails object
האובייקט contentDetails מכיל מידע על קטע וידאו, כולל אורך הסרטון ואינדיקציה אם יש כתוביות לסרטון.
contentDetails.duration string
אורך הסרטון. ערך המאפיין הוא משך זמן בפורמט ISO 8601. לדוגמה, בסרטון שאורכו דקה אחת לפחות ופחות משעה, משך הזמן הוא בפורמט PT#M#S, שבו האותיות PT מציינות שהערך מציין פרק זמן, והאותיות M ו-S מתייחסות לאורך בדקות ובשניות, בהתאמה. # התווים שלפני האותיות M ו-S הם מספרים שלמים שמציינים את מספר הדקות (או השניות) של הסרטון. לדוגמה, הערך PT15M33S מציין שאורך הסרטון הוא 15 דקות ו-33 שניות.

אם הסרטון הוא באורך של שעה לפחות, משך הזמן יהיה בפורמט PT#H#M#S, שבו # לפני האות H מציין את אורך הסרטון בשעות, וכל שאר הפרטים זהים לאלה שמתוארים למעלה. אם הסרטון נמשך לפחות יום אחד, האותיות P ו-T מופרדות, והפורמט של הערך הוא P#DT#H#M#S. פרטים מלאים זמינים במפרט ISO 8601.
contentDetails.dimension string
מציין אם הסרטון זמין בתלת-ממד או בדו-ממד.
contentDetails.definition string
מציין אם הסרטון זמין באיכות גבוהה (HD) או רק באיכות רגילה.

הערכים החוקיים של המאפיין הזה הם:
  • hd
  • sd
contentDetails.caption string
המאפיין הזה מציין אם יש כתוביות לסרטון.

הערכים התקפים של המאפיין הזה הם:
  • false
  • true
contentDetails.licensedContent boolean
מציין אם הסרטון מייצג תוכן ברישיון, כלומר שהתוכן הועלה לערוץ שמקושר לשותף תוכן של YouTube, ולאחר מכן השותף הזה הגיש תלונה על הפרת זכויות יוצרים.
contentDetails.regionRestriction object
האובייקט regionRestriction מכיל מידע על המדינות שבהן אפשר (או אי אפשר) לצפות בסרטון. האובייקט יכיל את המאפיין contentDetails.regionRestriction.allowed או את המאפיין contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
רשימה של קודי אזורים שמזהים מדינות שבהן אפשר לצפות בסרטון. אם המאפיין הזה קיים ומדינה מסוימת לא מופיעה בערך שלו, הסרטון חסום להצגה במדינה הזו. אם המאפיין הזה קיים ומכיל רשימה ריקה, הסרטון חסום בכל המדינות.
contentDetails.regionRestriction.blocked[] list
רשימה של קודי אזורים שמזהים מדינות שבהן הסרטון חסום. אם המאפיין הזה קיים ומדינה מסוימת לא מופיעה בערך שלו, הסרטון זמין לצפייה במדינה הזו. אם המאפיין הזה קיים והוא מכיל רשימה ריקה, אפשר לצפות בסרטון בכל המדינות.
contentDetails.contentRating object
מציין את הסיווגים שהסרטון קיבל לפי שיטות סיווג שונות.
contentDetails.contentRating.acbRating string
הסיווג של הסרטון מטעם Australian Classification Board (המועצה האוסטרלית לסיווג, ACB) או Australian Communications and Media Authority (הרשות האוסטרלית לתקשורת ומדיה, ACMA). סיווגי ACMA משמשים לסיווג תוכניות טלוויזיה לילדים.

הערכים התקינים למאפיין הזה הם:
  • ‫acbC – תוכניות שקיבלו סיווג C מאת Australian Communications and Media Authority (הרשות האוסטרלית לתקשורת ולמדיה). התוכניות האלה מיועדות לילדים (לא לילדים בגילאי הגן) מתחת לגיל 14.
  • acbE – E
  • acbG – G
  • acbM – M
  • ‫acbMa15plus – MA15+
  • acbP – תוכניות שקיבלו את הסיווג P על ידי Australian Communications and Media Authority (הרשות האוסטרלית לתקשורת ולמדיה). התוכניות האלה מיועדות לילדים בגילאי הגן.
  • ‫acbPg – PG
  • ‫acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating ‫string
סיווג הסרטון מטעם Autorità per le Garanzie nelle Comunicazioni (AGCOM) באיטליה.

הערכים התקפים של המאפיין הזה הם:
  • agcomT – T
  • agcomUnrated
  • ‫agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
סיווג הסרטון על ידי Anatel (Asociación Nacional de Televisión) לטלוויזיה בצ'ילה.

הערכים התקינים של המאפיין הזה הם:
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • ‫anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
סיווג הסרטון לפי המועצה הבריטית לסיווג סרטים (BBFC).

הערכים התקינים של המאפיין הזה הם:
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • ‫bbfc18 – 18
  • bbfcPg – PG
  • ‫bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
סיווג הסרטון שנקבע על ידי המועצה לצנזורה של סרטים וסרטונים בתאילנד.

הערכים החוקיים של המאפיין הזה הם:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
סיווג הסרטון לפי המועצה האוסטרית לסיווג מדיה (Bundesministerium für Unterricht, Kunst und Kultur).

הערכים החוקיים של המאפיין הזה הם:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14 ומעלה
  • bmukk16 – 16+
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa – בלי הגבלות
  • bmukkUnrated
contentDetails.contentRating.catvRating string
מערכת סיווג לטלוויזיה בקנדה – מערכת הסיווג לטלוויזיה בקנדה. הסיווג של הסרטון מטעם הוועדה הקנדית לרדיו, לטלוויזיה ולתקשורת (CRTC) לשידורים בקנדה בשפה האנגלית. מידע נוסף זמין באתר של Canadian Broadcast Standards Council (המועצה הקנדית לתקני שידור).

הערכים התקינים של המאפיין הזה הם:
  • catv14plus – מגיל 14 ומעלה
  • catv18plus – 18+
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
סיווג הסרטון של הוועדה הקנדית לרדיו, טלוויזיה ותקשורת (CRTC) לשידורים בצרפתית בקנדה. מידע נוסף זמין באתר של Canadian Broadcast Standards Council (המועצה הקנדית לתקני שידור).

הערכים התקינים של המאפיין הזה הם:
  • catvfr13plus – 13 ומעלה
  • catvfr16plus – 16+
  • catvfr18plus – 18+
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
סיווג הסרטון על ידי Central Board of Film Certification ‏ (CBFC – הודו).

הערכים התקפים של המאפיין הזה הם:
  • cbfcA – א'
  • ‫cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
סיווג הסרטון לפי Consejo de Calificación Cinematográfica (צ'ילה).

הערכים החוקיים של המאפיין הזה הם:
  • ccc14 – 14 ומעלה
  • ccc18 – 18+
  • ccc18s – 18+ - contenido pornográfico
  • ‫ccc18v – 18+ - contenido excesivamente violento
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – Todo espectador
  • cccUnrated
contentDetails.contentRating.cceRating string
סיווג הסרטון לפי Comissão de Classificação de Espect´culos בפורטוגל.

הערכים החוקיים של המאפיין הזה הם:
  • cceM12 – 12
  • cceM14 – 14
  • ‫cceM16 – 16
  • cceM18 – 18
  • cceM4 – 4
  • cceM6 – 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
סיווג הסרטון בשווייץ.

הערכים התקינים למאפיין הזה הם:
  • chfilm0 – 0
  • chfilm12 – 12
  • chfilm16 – 16
  • ‫chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
סיווג הסרטון לפי מערכת הסיווג של Canadian Home Video Rating System‏ (CHVRS).

הערכים התקינים למאפיין הזה הם:
  • chvrs14a – 14A
  • ‫chvrs18a – 18A
  • chvrsE – E
  • chvrsG – G
  • ‫chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
סיווג הסרטון לפי Commission de Contrôle des Films (בלגיה).

הערכים החוקיים של המאפיין הזה הם:
  • cicfE – E
  • ‫cicfKntEna – KNT/ENA
  • ‫cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
סיווג הסרטון לפי CONSILIUL NATIONAL AL AUDIOVIZUALULUI ‏ (CNA) ברומניה.

הערכים החוקיים של המאפיין הזה הם:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18+
  • ‫cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
מערכת הסיווג בצרפת – Commission de classification cinematographique

הערכים התקינים למאפיין הזה הם:
  • cnc10 – 10
  • cnc12 – 12
  • ‫cnc16 – 16
  • ‫cnc18 – 18
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
הסיווג של הסרטון לפי Conseil supérieur de l'audiovisuel בצרפת, שמסווג תוכן משודר.

הערכים החוקיים של המאפיין הזה הם:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • ‫csa18 – 18
  • csaInterdiction – חסימה
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
סיווג הסרטון לפי Commission de surveillance de la classification des films (CSCF)‎ בלוקסמבורג.

הערכים החוקיים של המאפיין הזה הם:
  • cscf12 – 12
  • cscf16 – 16
  • ‫cscf18 – 18
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – אלבניה
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
סיווג הסרטון בצ'כיה.

הערכים התקפים של המאפיין הזה הם:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
סיווג התוכן של הסרטון לפי Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - ברזיל).

הערכים החוקיים של המאפיין הזה הם:
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16
  • ‫djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
הסיבות לסיווג התוכן של הסרטון לפי DJCQT (ברזיל).
contentDetails.contentRating.ecbmctRating string
מערכת הסיווג בטורקיה – מועצת ההערכה והסיווג של משרד התרבות והתיירות

הערכים החוקיים של המאפיין הזה הם:
  • ecbmct13a – 13A
  • ecbmct13plus – מגיל 13 ומעלה
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18+
  • ecbmct7a – 7A
  • ecbmct7plus – 7+‎
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ‫ecbmct10a – 10A
  • ecbmct10plus – 10+
  • ecbmct16plus – 16+
contentDetails.contentRating.eefilmRating string
סיווג הסרטון באסטוניה.

הערכים התקינים של המאפיין הזה הם:
  • ‫eefilmK12 – K-12
  • eefilmK14 – K-14
  • eefilmK16 – K-16
  • ‫eefilmK6 – K-6
  • eefilmL – L
  • ‫eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – פרה
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
סיווג הסרטון במצרים.

הערכים החוקיים למאפיין הזה הם:
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
סיווג התוכן של הסרטון לפי Eirin‏ (映倫). ‫Eirin היא מערכת הסיווג היפנית.

הערכים התקינים למאפיין הזה הם:
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+‎
  • ‫eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
סיווג הסרטון לפי המועצה לצנזורה על סרטים במלזיה.

הערכים התקינים למאפיין הזה הם:
  • fcbm13 – 13
  • fcbm16 – 16
  • ‫fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • ‫fcbm18sg – 18SG
  • ‫fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
סיווג הסרטון לפי המשרד לניהול סרטים, עיתונים ומאמרים בהונג קונג.

הערכים החוקיים של המאפיין הזה הם:
  • fcoI – I
  • fcoIi – II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
המאפיין הזה יצא משימוש ב-2 בנובמבר 2015. במקום זאת, צריך להשתמש במאפיין contentDetails.contentRating.cncRating.

סיווג הסרטון על ידי Centre national du cinéma et de l'image animé (המרכז הלאומי לקולנוע ולתמונות מונפשות, משרד התרבות הצרפתי).

הערכים התקפים של המאפיין הזה הם:
  • fmoc10 – 10
  • fmoc12 – 12
  • ‫fmoc16 – 16
  • fmoc18 – 18
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
סיווג הסרטון לפי מועצת הסרטים והפרסומים של דרום אפריקה.

הערכים החוקיים של המאפיין הזה הם:
  • fpb10 – 10
  • fpb1012Pg – 10-12PG
  • fpb13 – 13
  • fpb16 – 16
  • ‫fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
הסיבות לסיווג התוכן של הסרטון לפי FPB (דרום אפריקה).
contentDetails.contentRating.fskRating string
סיווג הסרטון לפי Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – גרמניה).

הערכים החוקיים של המאפיין הזה הם:
  • ‫fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating ‫string
סיווג הסרטון ביוון.

הערכים התקפים של המאפיין הזה הם:
  • grfilmE – E
  • grfilmK – K
  • grfilmK12 – K-12
  • grfilmK13 – K-13
  • ‫grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating ‫string
הסיווג של הסרטון מטעם Instituto de la Cinematografía y de las Artes Audiovisuales‏ (ICAA – ספרד).

הערכים התקינים של המאפיין הזה הם:
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 – 16
  • ‫icaa18 – 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
הסיווג של הסרטון לפי המשרד האירי לסיווג סרטים (IFCO - אירלנד). מידע נוסף זמין באתר של IFCO.

הערכים החוקיים של המאפיין הזה הם:
  • ifco12 – 12
  • ifco12a – 12A
  • ifco15 – 15
  • ‫ifco15a – 15A
  • ifco16 – 16
  • ifco18 – 18
  • ifcoG – G
  • ‫ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
סיווג הסרטון בישראל.

הערכים התקפים של המאפיין הזה הם:
  • ilfilm12 – 12
  • ‫ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
סיווג הסרטון לפי INCAA (Instituto Nacional de Cine y Artes Audiovisuales – ארגנטינה).

הערכים החוקיים של המאפיין הזה הם:
  • ‫incaaAtp – ATP (Apta para todo publico)
  • ‫incaaC – X (לצפייה מגיל 18 ומעלה בלבד, בכפוף לתנאים)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • ‫incaaSam16 – 16 (Solo apta para mayores de 16 años)
  • incaaSam18 – 18 (Solo apta para mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
הסיווג של הסרטון מ-Kenya Film Classification Board (המועצה לסיווג סרטים בקניה).

הערכים התקפים של המאפיין הזה הם:
  • kfcb16plus – 16
  • kfcbG – GE
  • ‫kfcbPg – PG
  • ‫kfcbR – 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating ‫string
voor de Classificatie van Audiovisuele Media (Netherlands).

הערכים התקינים של המאפיין הזה הם:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • ‫kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
סיווג הסרטון של Korea Media Rating Board (ועדת סיווג התכנים של קוריאה). ה-KMRB מסווג סרטונים בדרום קוריאה.

הערכים התקינים של המאפיין הזה הם:
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – 전체관람가
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating ‫string
סיווג הסרטון מטעם Lembaga Sensor Film (המוסד לסיווג סרטים) באינדונזיה.

הערכים התקינים של המאפיין הזה הם:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – א'
  • lsfBo – BO
  • lsfD – D
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
הסיווג של הסרטון מ-Malta's Film Age-Classification Board (המועצה לסיווג סרטים לפי גיל במלטה).

הערכים התקפים של המאפיין הזה הם:
  • mccaa12 – 12
  • ‫mccaa12a – 12A
  • mccaa14 – 14 – הסיווג הזה הוסר ממבנה הסיווג החדש שהוצג ב-2013.
  • mccaa15 – 15
  • mccaa16 – 16 – הסיווג הזה הוסר ממבנה הסיווג החדש שהוצג ב-2013.
  • ‫mccaa18 – 18
  • mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
סיווג הסרטון לפי המועצה למדיה לילדים ולבני נוער של המכון הדני לקולנוע (Det Danske Filminstitut).

הערכים החוקיים של המאפיין הזה הם:
  • mccyp11 – 11
  • mccyp15 – 15
  • mccyp7 – 7
  • mccypA – א'
  • mccypUnrated
contentDetails.contentRating.mcstRating string
מערכת הסיווג של הסרטון בווייטנאם – MCST

הערכים התקינים של המאפיין הזה הם:
  • mcst0 – 0
  • mcst16plus – 16+
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
contentDetails.contentRating.mdaRating ‫string
סיווג הסרטון על ידי הרשות לפיתוח מדיה (MDA) בסינגפור, ובאופן ספציפי, על ידי הוועדה לסיווג סרטים (BFC).

הערכים התקפים של המאפיין הזה הם:
  • mdaG – G
  • mdaM18 – M18
  • ‫mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • ‫mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
הסיווג של הסרטון מטעם Medietilsynet, הרשות הנורווגית לתקשורת.

הערכים התקינים של המאפיין הזה הם:
  • medietilsynet11 – 11
  • medietilsynet12 – 12
  • medietilsynet15 – 15
  • medietilsynet18 – 18
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA – א'
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating ‫string
סיווג הסרטון מטעם Kansallinen Audiovisuaalinen Instituutti (המכון הלאומי לאודיו-ויזואל) בפינלנד.

הערכים התקינים של המאפיין הזה הם:
  • meku12 – 12
  • ‫meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • ‫mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
סיווג הסרטון לפי Ministero dei Beni e delle Attività Culturali e del Turismo (איטליה).

הערכים החוקיים למאפיין הזה הם:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
סיווג הסרטון לפי Ministerio de Cultura (קולומביה).

הערכים התקינים של המאפיין הזה הם:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned – אסור להפצה
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating ‫string
סיווג הסרטון מטעם משרד התרבות (文化部) בטייוואן.

הערכים התקפים של המאפיין הזה הם:
  • moctwG – G
  • moctwP – P
  • moctwPg – PG
  • moctwR – R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
סיווג התוכן של הסרטון לפי איגוד הסרטים האמריקאי (MPAA).

הערכים החוקיים של המאפיין הזה הם:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating ‫string
הסיווג של איגוד MPAA לטריילרים ולתצוגות מקדימות של סרטים.

הערכים התקינים של המאפיין הזה הם:
  • mpaatGb – GB (Green Band – מתאים לכל הקהלים)
  • mpaatRb – RB (Red Band - מומלץ לגילאי 17 ומעלה)
contentDetails.contentRating.mtrcbRating string
הסיווג של הסרטון מ-Movie and Television Review and Classification Board (הפיליפינים).
הערכים התקפים של המאפיין הזה הם:

  • mtrcbG – G
  • mtrcbPg – PG
  • ‫mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating ‫string
הסיווג של הסרטון מטעם הלשכה הלאומית לסיווג של המלדיבים.

הערכים התקפים של המאפיין הזה הם:
  • nbc12plus – 12+
  • ‫nbc15plus – 15+
  • nbc18plus – 18+
  • ‫nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating ‫string
הסיווג של הסרטון מהמרכז הלאומי לקולנוע בבולגריה.

הערכים התקפים של המאפיין הזה הם:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
סיווג הסרטון לפי המועצה הלאומית לצנזורה של סרטים וסרטונים בניגריה.

הערכים החוקיים של המאפיין הזה הם:
  • nfvcb12 – 12
  • ‫nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
סיווג הסרטון לפי Nacionãlais Kino centrs (מרכז הקולנוע הלאומי של לטביה).

הערכים החוקיים של המאפיין הזה הם:
  • nkclv12plus – 12+‎
  • nkclv18plus – 18+
  • nkclv7plus – 7+‎
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
הסיווג של הסרטון מטעם Office of Film and Literature Classification‏ (OFLC – ניו זילנד).

הערכים התקפים של המאפיין הזה הם:
  • oflcG – G
  • oflcM – M
  • oflcPg – PG
  • oflcR13 – R13
  • ‫oflcR15 – R15
  • ‫oflcR16 – R16
  • ‫oflcR18 – R18
  • oflcRp13 – RP13
  • ‫oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
סיווג הסרטון בפרו.

הערכים התקינים למאפיין הזה הם:
  • pefilm14 – 14
  • pefilm18 – 18
  • ‫pefilmPg – PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
סיווג הסרטון בוונצואלה.

הערכים התקפים של המאפיין הזה הם:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – ד'
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
הסיווג של הסרטון לפי General Directorate of Radio, Television and Cinematography (מקסיקו).

הערכים התקינים למאפיין הזה הם:
  • rtcA – א'
  • rtcAa – AA
  • rtcB – B
  • ‫rtcB15 – B15
  • rtcC – C
  • rtcD – ד'
  • rtcUnrated
contentDetails.contentRating.rteRating string
סיווג הסרטון לפי Raidió Teilifís Éireann באירלנד.

הערכים התקינים של המאפיין הזה הם:
  • rteCh – CH
  • ‫rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
סיווג התוכן של הסרטון לפי המרשם הלאומי לסרטים של הפדרציה הרוסית (MKRF – רוסיה).

הערכים התקינים של המאפיין הזה הם:
  • russia0 – 0+‎
  • russia12 – 12+‎
  • russia16 – 16+
  • russia18 – 18+
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
סיווג הסרטון בסלובקיה.

הערכים התקינים של המאפיין הזה הם:
  • skfilmG – G
  • ‫skfilmP2 – P2
  • ‫skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
סיווג הסרטון באיסלנד.

הערכים החוקיים למאפיין הזה הם:
  • smais12 – 12
  • smais14 – 14
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
סיווג הסרטון מטעם Statens medieråd (המועצה הלאומית למדיה בשוודיה).

הערכים התקפים של המאפיין הזה הם:
  • smsa11 – 11
  • smsa15 – 15
  • smsa7 – 7
  • smsaA – לכל הגילים
  • smsaUnrated
contentDetails.contentRating.tvpgRating ‫string
הסיווג של הסרטון לפי TV Parental Guidelines (הנחיות להורים בנוגע לתוכניות טלוויזיה, TVPG).

הערכים התקפים של המאפיין הזה הם:
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg – TV-PG
  • tvpgUnrated
  • tvpgY – TV-Y
  • tvpgY7 – TV-Y7
  • ‫tvpgY7Fv – TV-Y7-FV
  • pg14 – TV-14
contentDetails.contentRating.ytRating string
סיווג שמשמש את YouTube לזיהוי תוכן שחלה עליו הגבלת גיל.

הערכים התקינים של המאפיין הזה הם:
  • ytAgeRestricted
contentDetails.projection string
מציין את פורמט ההיטל של הסרטון.

הערכים התקינים של המאפיין הזה הם:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
מציין אם המשתמש שהעלה את הסרטון סיפק תמונה ממוזערת מותאמת אישית לסרטון. המאפיין הזה גלוי רק למי שהעלה את הסרטון.
status object
אובייקט status מכיל מידע על סטטוס ההעלאה, העיבוד והפרטיות של הסרטון.
status.uploadStatus string
הסטטוס של הסרטון שהועלה.

הערכים התקינים של המאפיין הזה הם:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
הערך הזה מסביר למה העלאת הסרטון נכשלה. המאפיין הזה מופיע רק אם המאפיין uploadStatus מציין שההעלאה נכשלה.

הערכים החוקיים של המאפיין הזה הם:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
הערך הזה מסביר למה YouTube דחה סרטון שהועלה. המאפיין הזה קיים רק אם המאפיין uploadStatus מציין שההעלאה נדחתה.

הערכים החוקיים של המאפיין הזה הם:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
סטטוס הפרטיות של הסרטון. בבקשת videos.insert, אם לא מציינים ערך למאפיין הזה, סטטוס הפרטיות של הסרטון שהועלה מוגדר כברירת מחדל כ-public. העלאות מסוימות עשויות להיות מוגדרות כ-private כברירת מחדל, בהתאם להגדרות החשבון של היוצר, כפי שמוסבר במרכז העזרה של YouTube. סרטונים שהועלו מפרויקטים של API לא מאומתים לא מוגבלים למצב צפייה פרטי.

הערכים החוקיים של המאפיין הזה הם:
  • private
  • public
  • unlisted
status.publishAt datetime
התאריך והשעה שבהם הסרטון מתוזמן לפרסום. אפשר להגדיר את זה רק אם סטטוס הפרטיות של הסרטון הוא "פרטי". הערך מצוין בפורמט ISO 8601. חשוב לשים לב לשתי הנקודות הנוספות הבאות לגבי ההתנהגות של הנכס הזה:
  • אם מגדירים את הערך של המאפיין הזה כשמפעילים את השיטה videos.update, צריך גם להגדיר את הערך של המאפיין status.privacyStatus בתור private, גם אם הסרטון כבר פרטי.
  • אפשר להגדיר את המאפיין הזה רק אם סטטוס הפרטיות של הסרטון הוא private והסרטון מעולם לא פורסם.
  • אם הבקשה שלכם מתזמנת פרסום של סרטון במועד שכבר עבר, הסרטון יפורסם מיד. לכן, ההשפעה של הגדרת המאפיין status.publishAt לתאריך ולשעה בעבר זהה לשינוי של privacyStatus הסרטון מ-private ל-public.
status.license string
הרישיון של הסרטון.

הערכים החוקיים של המאפיין הזה הם:
  • creativeCommon
  • youtube
status.embeddable boolean
הערך הזה מציין אם אפשר להטמיע את הסרטון באתר אחר.
status.publicStatsViewable boolean
הערך הזה מציין אם נתוני הצפייה המורחבים של הסרטון בדף הצפייה שלו גלויים לכולם. כברירת מחדל, הנתונים הסטטיסטיים האלה גלויים, ונתונים סטטיסטיים כמו מספר הצפיות והדירוגים של הסרטון עדיין יהיו גלויים לכולם גם אם הערך של המאפיין הזה מוגדר כ-false.
status.madeForKids boolean
הערך הזה מציין אם הסרטון מוגדר כתוכן שמיועד לילדים, והוא כולל את הסטטוס הנוכחי של הסרטון בקטגוריה 'במיוחד לילדים'. לדוגמה, יכול להיות שהסטטוס ייקבע על סמך הערך של המאפיין selfDeclaredMadeForKids. במרכז העזרה של YouTube אפשר למצוא מידע נוסף על הגדרת הקהל של הערוץ, הסרטונים או השידורים.
status.selfDeclaredMadeForKids boolean
בבקשת videos.insert או videos.update, המאפיין הזה מאפשר לבעלי הערוץ לציין שהסרטון מיועד לילדים. בבקשת videos.list, ערך המאפיין מוחזר רק אם בעלי הערוץ אישרו את בקשת ה-API.
status.containsSyntheticMedia boolean
בבקשת videos.insert או videos.update, המאפיין הזה מאפשר לבעלי הערוץ לחשוף שסרטון מכיל תוכן מציאותי שעבר שינוי או נוצר באופן סינתטי (A/S). מידע נוסף על כללי המדיניות של YouTube בנושא תוכן שקשור לניצול או להתעללות מינית בילדים

דוגמאות לתוכן שנוצר על ידי AS:
  • הצגה של אדם אמיתי שאומר או עושה משהו שלא אמר או עשה בפועל
  • נעשה שינוי בחומר מצולם של אירוע או מקום אמיתיים
  • בתוכן מוצגת סצנה שנראית אמיתית אבל לא התרחשה באמת
statistics object
האובייקט statistics מכיל נתונים סטטיסטיים על הסרטון.
statistics.viewCount unsigned long

מספר הפעמים שבהן צפו בסרטון.

החל מ-24 באוגוסט 2026, בכל פורמטי הסרטונים (סרטונים ארוכים, שידורים חיים וסרטוני Shorts) בערוץ, viewCount יעודכן כך שיספור צפיות מהרגע שבו הסרטון מתחיל לפעול (כולל הפעלה אוטומטית, החזקת מצביע העכבר מעל הסרטון ולחיצה או הקשה להפעלה).
statistics.likeCount unsigned long
מספר המשתמשים שסימנו לייק לסרטון.
statistics.dislikeCount unsigned long
הערה: המאפיין statistics.dislikeCount הפך לפרטי ב-13 בדצמבר 2021. כלומר, המאפיין נכלל בתגובה מה-API רק אם בקשת ה-API אומתה על ידי הבעלים של הסרטון. למידע נוסף, עיינו בהיסטוריית הגרסאות.

מספר המשתמשים שציינו שהם לא אהבו את הסרטון.
statistics.favoriteCount unsigned long
הערה: המאפיין הזה הוצא משימוש. ההוצאה משימוש נכנסה לתוקף ב-28 באוגוסט 2015. הערך של המאפיין מוגדר עכשיו תמיד ל-0.
statistics.commentCount unsigned long
מספר התגובות לסרטון.
paidProductPlacementDetails object
האובייקט paidProductPlacementDetails מכיל מידע על שילוב מוצר בתשלום בסרטון.
paidProductPlacementDetails.hasPaidProductPlacement boolean
צריך להגדיר את הערך true אם התוכן כולל שילוב מוצר בתשלום. ברירת המחדל היא false.
player object
האובייקט player מכיל מידע שמשמש להפעלת הסרטון בנגן מוטמע.
player.embedHtml string
תג <iframe> שמטמיע נגן שמפעיל את הסרטון.
  • אם בקשת ה-API לאחזור המשאב מציינת ערך לפרמטרים maxHeight ו/או maxWidth, גודל הנגן המוטמע מותאם כדי לעמוד בדרישות של maxHeight ו/או maxWidth.
  • אם יחס הגובה-רוחב של הסרטון לא ידוע, נגן הווידאו המוטמע מוגדר כברירת מחדל לפורמט 4:3.
player.embedHeight long
הגובה של הנגן המוטמע שמוחזר במאפיין player.embedHtml. המאפיין הזה מוחזר רק אם בבקשה צוין ערך לפרמטרים maxHeight או maxWidth, ויחס הגובה-רוחב של הסרטון ידוע.
player.embedWidth long
רוחב הנגן המוטמע שמוחזר במאפיין player.embedHtml. המאפיין הזה מוחזר רק אם הבקשה ציינה ערך לפרמטרים maxHeight ו/או maxWidth ויחס הגובה-רוחב של הסרטון ידוע.
topicDetails object
האובייקט topicDetails כולל מידע על נושאים שמשויכים לסרטון.

חשוב: כדי לקבל פרטים נוספים על השינויים הצפויים שקשורים למזהי הנושאים, כדאי לעיין בהגדרות של המאפיינים topicDetails.relevantTopicIds[] ו-topicDetails.topicIds[] וגם בהיסטוריית הגרסאות.
topicDetails.topicIds[] list
חשוב: הנכס הזה הוצא משימוש החל מ-10 בנובמבר 2016. ה-API כבר לא מחזיר ערכים למאפיין הזה, וכל הנושאים שמשויכים לסרטון מוחזרים עכשיו על ידי ערך המאפיין topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[] list
רשימה של מזהי נושאים שרלוונטיים לסרטון.

המאפיין הזה הוצא משימוש החל מ-10 בנובמבר 2016. התמיכה בו תימשך עד 10 בנובמבר 2017.

חשוב: בעקבות ההוצאה משימוש של Freebase ושל Freebase API, מזהי הנושאים פועלים באופן שונה החל מ-27 בפברואר 2017. באותו זמן, המערכת של YouTube התחילה להחזיר קבוצה קטנה של מזהי נושאים שנבחרו בקפידה.
topicDetails.topicCategories[] list
רשימה של כתובות URL בוויקיפדיה שמספקות תיאור כללי של תוכן הסרטון.
recordingDetails object
האובייקט recordingDetails כולל מידע על המיקום, התאריך והכתובת שבהם הסרטון הוקלט.
recordingDetails.locationDescription string
המאפיין הזה הוצא משימוש ב-1 ביוני 2017. פרטים נוספים זמינים בהודעה על הוצאה משימוש.

תיאור טקסטואלי של המיקום שבו הסרטון צולם.
recordingDetails.location object
המאפיין הזה הוצא משימוש. כל מאפייני הצאצא שלו (קו רוחב, קו אורך, גובה) הוצאו משימוש.

פרטי המיקום הגיאוגרפי שמשויכים לסרטון. הערכים של הנכס המשני מציינים את המיקום שבעל הסרטון רוצה לשייך לסרטון. אפשר לערוך את הערך, לחפש אותו בסרטונים שגלויים לכולם, והוא עשוי להיות מוצג למשתמשים בסרטונים שגלויים לכולם.
recordingDetails.location.latitude double
המאפיין הזה הוצא משימוש החל מ-1 ביוני 2017. פרטים נוספים זמינים בהודעה הזו.

קו הרוחב במעלות.
recordingDetails.location.longitude double
המאפיין הזה הוצא משימוש החל מ-1 ביוני 2017. פרטים נוספים זמינים בהודעה על הוצאה משימוש.

קו אורך במעלות.
recordingDetails.location.altitude double
המאפיין הזה הוצא משימוש ב-9 ביולי 2018. פרטים נוספים זמינים בהודעה על הוצאה משימוש.

גובה מעל פני הים ביחס לאליפסואיד הייחוס, במטרים.
recordingDetails.recordingDate datetime
התאריך והשעה שבהם הסרטון צולם. הערך מצוין בפורמט ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
האובייקט fileDetails מכיל מידע על קובץ הווידאו שהועלה ל-YouTube, כולל הרזולוציה, משך הזמן, קודק האודיו והווידאו, קצב העברת הנתונים של הסטרימינג ועוד. רק הבעלים של הסרטון יכולים לאחזר את הנתונים האלה.

האובייקט fileDetails יוחזר רק אם הערך של המאפיין processingDetails.fileAvailability הוא available.
fileDetails.fileName string
שם הקובץ שהועלה. השדה הזה מופיע גם אם הועלה קובץ וידאו וגם אם הועלה סוג אחר של קובץ.
fileDetails.fileSize unsigned long
גודל הקובץ שהועלה, בבייטים. השדה הזה מופיע גם אם הועלה קובץ וידאו וגם אם הועלה קובץ מסוג אחר.
fileDetails.fileType string
סוג הקובץ שהועלה, כפי שזוהה על ידי מנוע עיבוד הווידאו של YouTube. נכון לעכשיו, המערכת של YouTube מעבדת רק קובצי וידאו, אבל השדה הזה מופיע גם אם הועלה קובץ וידאו וגם אם הועלה קובץ מסוג אחר.

הערכים החוקיים של המאפיין הזה הם:
  • ‫archive – הקובץ הוא קובץ ארכיון, כמו ארכיון zip.
  • ‫audio – הקובץ הוא מסוג קובץ אודיו מוכר, כמו קובץ ‎ .mp3.
  • document – הקובץ הוא מסמך או קובץ טקסט, כמו מסמך MS Word.
  • image – הקובץ הוא קובץ תמונה, כמו תמונה בפורמט ‎ .jpeg.
  • ‫other – הקובץ הוא מסוג קובץ אחר שאינו סוג קובץ וידאו.
  • project – הקובץ הוא קובץ פרויקט של סרטון, כמו פרויקט של Microsoft Windows Movie Maker, שלא מכיל נתוני וידאו בפועל.
  • video – הקובץ הוא מסוג קובץ וידאו מוכר, כמו קובץ ‎ .mp4.
fileDetails.container string
פורמט המאגר של קובץ הסרטון שהועלה.
fileDetails.videoStreams[] list
רשימה של זרמי וידאו שנכללים בקובץ הסרטון שהועלה. כל פריט ברשימה מכיל מטא-נתונים מפורטים על שידור וידאו.
fileDetails.videoStreams[].widthPixels unsigned integer
רוחב קטע הווידאו המקודד בפיקסלים. אפשר לחשב את יחס הגובה-רוחב של הקידוד של הסרטון כך: width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
הגובה בפיקסלים של קטע הווידאו המקודד.
fileDetails.videoStreams[].frameRateFps double
קצב הפריימים של שידור הווידאו, ב-FPS.
fileDetails.videoStreams[].aspectRatio double
יחס הגובה-רוחב של קטע הווידאו, שמציין את יחס הגובה-רוחב שבו הסרטון צריך להופיע.
fileDetails.videoStreams[].codec string
קודק הווידאו שבו משתמשים בשידור.
fileDetails.videoStreams[].bitrateBps unsigned long
קצב העברת הנתונים של שידור הווידאו, בביטים לשנייה.
fileDetails.videoStreams[].rotation string
המידה שבה המערכת של YouTube צריכה לסובב את תוכן המקור כדי להציג את הסרטון בצורה תקינה.

הערכים התקינים של המאפיין הזה הם:
  • ‫clockwise – צריך לסובב את הסרטון ב-90 מעלות בכיוון השעון.
  • counterClockwise – צריך לסובב את הסרטון ב-90 מעלות נגד כיוון השעון.
  • ‫none – אין צורך לסובב את הסרטון.
  • ‫other – צריך לסובב את הסרטון בדרך אחרת, לא טריוויאלית.
  • ‫upsideDown – צריך לסובב את הסרטון הפוך.
fileDetails.videoStreams[].vendor string
ערך שמזהה באופן ייחודי ספק וידאו. בדרך כלל, הערך הוא קוד ספק בן ארבע אותיות.
fileDetails.audioStreams[] list
רשימה של נתוני אודיו שכלולים בקובץ הווידאו שהועלה. כל פריט ברשימה מכיל מטא-נתונים מפורטים על שידור אודיו.
fileDetails.audioStreams[].channelCount unsigned integer
מספר ערוצי האודיו שהשידור מכיל.
fileDetails.audioStreams[].codec string
קודק האודיו שבו משתמשים בשידור.
fileDetails.audioStreams[].bitrateBps unsigned long
קצב העברת הנתונים של שידור האודיו, בביטים לשנייה.
fileDetails.audioStreams[].vendor string
ערך שמזהה באופן ייחודי ספק של סרטונים. בדרך כלל, הערך הוא קוד ספק בן ארבע אותיות.
fileDetails.durationMs unsigned long
אורך הסרטון שהועלה באלפיות השנייה.
fileDetails.bitrateBps unsigned long
קצב העברת הנתונים המשולב (וידאו ואודיו) של קובץ הסרטון שהועלה, בביטים לשנייה.
fileDetails.creationTime string
התאריך והשעה שבהם נוצר קובץ הסרטון שהועלה. הערך מצוין בפורמט ISO 8601. בשלב הזה, הפורמטים הבאים של ISO 8601 נתמכים:
  • תאריך בלבד: YYYY-MM-DD
  • זמן ללא אזור זמן: YYYY-MM-DDTHH:MM:SS
  • שעה עם אזור זמן: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
האובייקט processingDetails כולל מידע על ההתקדמות של YouTube בעיבוד קובץ הווידאו שהועלה. המאפיינים באובייקט מציינים את סטטוס העיבוד הנוכחי ואת הזמן שנותר עד ש-YouTube יסיים לעבד את הסרטון. בחלק הזה מצוין גם אם יש נתונים או תוכן מסוגים שונים שקשורים לסרטון, כמו פרטי הקובץ או תמונות ממוזערות.‫

אובייקט processingProgress מיועד לבדיקה חוזרת, כדי לעקוב אחר ההתקדמות של YouTube בעיבוד קובץ הסרטון שהועלה. רק הבעלים של הסרטון יכולים לאחזר את הנתונים האלה.
processingDetails.processingStatus string
סטטוס העיבוד של הסרטון. הערך הזה מציין אם מערכת YouTube הצליחה לעבד את הסרטון או אם העיבוד של הסרטון עדיין מתבצע.

הערכים התקינים של המאפיין הזה הם:
  • ‫failed – עיבוד הסרטון נכשל. מידע נוסף זמין במאמר בנושא ProcessingFailureReason.
  • processing – הסרטון בתהליך עיבוד. מידע נוסף זמין במאמר ProcessingProgress.
  • ‫succeeded – עיבוד הסרטון הסתיים.
  • ‫terminated – פרטי העיבוד לא זמינים יותר.
processingDetails.processingProgress object
האובייקט processingProgress מכיל מידע על ההתקדמות של YouTube בעיבוד הסרטון. הערכים רלוונטיים רק אם סטטוס העיבוד של הסרטון הוא processing.
processingDetails.processingProgress.partsTotal unsigned long
הערכה של המספר הכולל של החלקים שצריך לעבד בסרטון. המספר עשוי להתעדכן עם אומדנים מדויקים יותר בזמן ש-YouTube מעבד את הסרטון.
processingDetails.processingProgress.partsProcessed unsigned long
מספר החלקים בסרטון ש-YouTube כבר עיבד. כדי להעריך את אחוז הסרטון שכבר עבר עיבוד ב-YouTube, אפשר לחשב את הנתון הבא:
100 * parts_processed / parts_total

שימו לב: יכול להיות שמספר החלקים המשוער יגדל בלי שמספר החלקים שכבר עברו עיבוד יגדל בהתאם. לכן, יכול להיות שההתקדמות המחושבת תקטן מדי פעם בזמן ש-YouTube מעבד סרטון.
processingDetails.processingProgress.timeLeftMs unsigned long
הערכה של משך הזמן, באלפיות השנייה, שיידרש ל-YouTube כדי לסיים את עיבוד הסרטון.
processingDetails.processingFailureReason string
הסיבה לכך שעיבוד הסרטון ב-YouTube נכשל. למאפיין הזה יהיה ערך רק אם הערך של המאפיין processingStatus הוא failed.

הערכים החוקיים של המאפיין הזה הם:
  • ‫other – רכיב עיבוד אחר נכשל.
  • ‫streamingFailed – אי אפשר לשלוח סרטונים לסטרימרים.
  • ‫transcodeFailed – המרת הקידוד של התוכן נכשלה.
  • ‫uploadFailed – מסירת הקובץ נכשלה.
processingDetails.fileDetailsAvailability string
הערך הזה מציין אם פרטי הקובץ זמינים לסרטון שהועלה. כדי לאחזר את פרטי הקובץ של סרטון, צריך לבקש את החלק fileDetails בבקשת videos.list().
processingDetails.processingIssuesAvailability string
הערך הזה מציין אם מנוע עיבוד הסרטונים יצר הצעות שיכולות לשפר את היכולת של YouTube לעבד את הסרטון, אזהרות שמסבירות בעיות בעיבוד הסרטון או שגיאות שגורמות לבעיות בעיבוד הסרטון. כדי לאחזר את ההצעות האלה, צריך לבקש את החלק suggestions בבקשת videos.list().
processingDetails.tagSuggestionsAvailability string
הערך הזה מציין אם יש הצעות למילות מפתח (תגים) לסרטון. אפשר להוסיף תגים למטא-נתונים של סרטון כדי להקל על משתמשים אחרים למצוא את הסרטון. כדי לקבל את ההצעות האלה, צריך לבקש את החלק suggestions בבקשה videos.list().
processingDetails.editorSuggestionsAvailability string
הערך הזה מציין אם יש הצעות לעריכת הסרטון, שיכולות לשפר את איכות הסרטון או את חוויית הצפייה. כדי לקבל את ההצעות האלה, צריך לבקש את החלק suggestions בבקשה videos.list().
processingDetails.thumbnailsAvailability string
הערך הזה מציין אם נוצרו תמונות ממוזערות לסרטון.
suggestions object
אובייקט suggestions מכיל הצעות לשיפור איכות הסרטון או המטא-נתונים של הסרטון שהועלה. רק הבעלים של הסרטון יכולים לאחזר את הנתונים האלה. ‫

האובייקט suggestions יוחזר רק אם המאפיין processingDetails.tagSuggestionsAvailability או המאפיין processingDetails.editorSuggestionsAvailability מכילים את הערך available.
suggestions.processingErrors[] list
רשימה של שגיאות שימנעו מ-YouTube לעבד את הסרטון שהועלה. השגיאות האלה מציינות שללא קשר לסטטוס העיבוד הנוכחי של הסרטון, בסופו של דבר הסטטוס הזה יהיה כמעט בוודאות failed.

הערכים התקינים של המאפיין הזה הם:
  • ‫archiveFile – קובץ ארכיון (למשל, ארכיון ZIP).
  • audioFile – הקובץ מכיל אודיו בלבד (למשל, קובץ MP3).
  • ‫docFile – מסמך או קובץ טקסט (למשל, מסמך MS Word).
  • ‫imageFile – קובץ תמונה (לדוגמה, תמונה בפורמט JPEG).
  • ‫notAVideoFile – קובץ אחר שהוא לא קובץ וידאו.
  • ‫projectFile – קובץ פרויקט של סרט (למשל, פרויקט של Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
רשימת סיבות שבגללן יכול להיות ש-YouTube יתקשה לבצע המרה של הסרטון שהועלה, או שיוביל להמרה שגויה. האזהרות האלה נוצרות לפני ש-YouTube מעבד בפועל את קובץ הווידאו שהועלה. בנוסף, הם מזהים בעיות שלא בהכרח מצביעות על כך שעיבוד הסרטון ייכשל, אבל עדיין עלולות לגרום לבעיות כמו בעיות בסנכרון, פגמים בסרטון או טראק אודיו חסר.

הערכים החוקיים של המאפיין הזה הם:
  • hasEditlist – כרגע אין תמיכה ברשימות עריכה.
  • ‫inconsistentResolution – רזולוציות שונות של הקונטיינר והסטרימינג.
  • ‫problematicAudioCodec – נעשה שימוש בקודק אודיו שידוע כגורם לבעיות.
  • ‫problematicVideoCodec – נעשה שימוש בקודק וידאו שידוע כגורם לבעיות.
  • unknownAudioCodec – קודק אודיו לא מזוהה, סביר להניח שהמרת הקידוד תיכשל.
  • ‫unknownContainer – פורמט קובץ לא מזוהה, סביר להניח שהמרת הקידוד תיכשל.
  • unknownVideoCodec – קודק וידאו לא מזוהה, סביר להניח שהמרת הקידוד תיכשל.
suggestions.processingHints[] list
רשימה של הצעות שעשויות לשפר את היכולת של YouTube לעבד את הסרטון.

הערכים החוקיים של המאפיין הזה הם:
  • nonStreamableMov – אי אפשר להעביר את קובץ ה-MP4 בסטרימינג, וזה יאט את העיבוד.
  • sendBestQualityVideo – כנראה שיש גרסה של הסרטון באיכות טובה יותר.
suggestions.tagSuggestions[] list
רשימה של תגי מילות מפתח שאפשר להוסיף למטא-נתונים של הסרטון כדי להגדיל את הסיכוי שהמשתמשים ימצאו את הסרטון שלכם כשהם מחפשים או גולשים ב-YouTube.
suggestions.tagSuggestions[].tag string
תג מילת המפתח שהוצע לסרטון.
suggestions.tagSuggestions[].categoryRestricts[] list
קבוצה של קטגוריות סרטונים שהתג רלוונטי לגביהן. אתם יכולים להשתמש במידע הזה כדי להציג הצעות לתגים מתאימים על סמך קטגוריית הסרטון שמעלה הסרטון משייך לסרטון. כברירת מחדל, הצעות לתגים רלוונטיות לכל הקטגוריות אם לא הוגדרו הגבלות למילת המפתח.
suggestions.editorSuggestions[] list
רשימה של פעולות עריכת וידאו שעשויות לשפר את איכות הווידאו או את חוויית ההפעלה של הסרטון שהועלה.

הערכים החוקיים של המאפיין הזה הם:
  • ‫audioQuietAudioSwap – נראה שטראק האודיו שקט, ואפשר להחליף אותו בטראק באיכות טובה יותר.
  • videoAutoLevels – נראה שרמות הבהירות של התמונה לא תקינות ואפשר לתקן אותן.
  • ‫videoCrop – יכול להיות ששוליים (מט) שזוהו מסביב לתמונה ייחתכו.
  • ‫videoStabilize – הסרטון נראה רועד ואפשר לייצב אותו.
liveStreamingDetails object
האובייקט liveStreamingDetails מכיל מטא-נתונים על שידור וידאו חי. האובייקט יהיה קיים במשאב video רק אם הסרטון הוא שידור חי קרוב, שידור חי פעיל או שידור חי שהסתיים.
liveStreamingDetails.actualStartTime datetime
השעה שבה השידור התחיל בפועל. הערך מצוין בפורמט ISO 8601. הערך הזה לא יהיה זמין עד שהשידור יתחיל.
liveStreamingDetails.actualEndTime datetime
השעה שבה השידור הסתיים בפועל. הערך מצוין בפורמט ISO 8601. הערך הזה לא יהיה זמין עד שהשידור יסתיים.
liveStreamingDetails.scheduledStartTime datetime
השעה שבה השידור מתוכנן להתחיל. הערך מצוין בפורמט ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
השעה שבה השידור אמור להסתיים. הערך מצוין בפורמט ISO 8601. אם הערך ריק או שהמאפיין לא קיים, השידור מתוזמן להמשיך ללא הגבלת זמן.
liveStreamingDetails.concurrentViewers unsigned long
מספר הצופים שצופים כרגע בשידור. המאפיין והערך שלו יוצגו אם יש שידור עם צופים נוכחיים ובעלי השידור לא הסתירו את מספר הצפיות בסרטון. הערה: מערכת YouTube מפסיקה לעקוב אחרי מספר הצופים בו-זמנית בשידור כשהשידור מסתיים. לכן, המאפיין הזה לא יזהה את מספר הצופים שצופים בסרטון שנשמר בארכיון של שידור חי שכבר הסתיים.
מספר הצופים בו-זמנית שמוחזר על ידי YouTube Data API עשוי להיות שונה ממספר הצופים בו-זמנית שעבר עיבוד וסינון ספאם, שזמין דרך YouTube Analytics. מידע נוסף על מדדים של שידור חי זמין במרכז העזרה של YouTube.
liveStreamingDetails.activeLiveChatId string
המזהה של הצ'אט בשידור חי שפעיל כרגע ומצורף לסרטון הזה. השדה הזה מתמלא רק אם הסרטון הוא שידור חי שכולל צ'אט בשידור חי. כשהשידור יסתיים, השדה הזה יוסר והצ'אט בשידור חי ייסגר. בשידורים קבועים, המזהה של הצ'אט בשידור חי לא יהיה מקושר יותר לסרטון הזה, אלא לסרטון החדש שמוצג בדף הקבוע.
brandPartner object
האובייקט brandPartner מכיל פרטים על שותף המותג שמקושר לסרטון לצורך גישה לשותפי מותג ביוזמת היוצרים (CI BPA).
brandPartner.channelId string
מזהה הערוץ החיצוני של השותף עם המותג. השדה הזה חייב להתחיל ב-"UC". צריך להגדיר את channelId או את channelHandle כשמגדירים גישה, אבל רק channelId מוחזר בתגובה.
brandPartner.channelHandle string
הכינוי של שותף המותג. השדה הזה חייב להתחיל ב-"@". צריך להגדיר את channelId או את channelHandle כשמגדירים גישה, אבל רק channelId מוחזר בתגובה.
localizations object
האובייקט localizations מכיל תרגומים של המטא-נתונים של הסרטון.
localizations.(key) object
השפה של הטקסט המותאם לשוק המקומי שמשויך לערך המפתח. הערך הוא מחרוזת שמכילה קוד שפה בתקן BCP-47.
localizations.(key).title string
שם הסרטון המותאם לשוק המקומי.
localizations.(key).description string
תיאור הסרטון המותאם לשוק המקומי.