Videos

כל הסרטונים שהועלו באמצעות נקודת הקצה videos.insert מפרויקטים לא מאומתים ב-API שנוצרו אחרי 28 ביולי 2020 יוגבלו למצב צפייה 'פרטי'. כדי להסיר את ההגבלה, כל פרויקט ב-API צריך לעבור בדיקה כדי לוודא שהוא עומד בתנאים ובהגבלות. לפרטים נוספים, אפשר לעיין בהיסטוריית הגרסאות של ה-API.

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

שיטות

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

getRating

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

list

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

הוספה

מעלים סרטון ל-YouTube ומגדירים את המטא-נתונים של הסרטון.

עדכון

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

מחיקה

מוחק סרטון ב-YouTube. כדאי לנסות עכשיו.

rate [שיעור]

ניתן להוסיף לסרטון דירוג של לייק או דיסלייק או להסיר דירוג מסרטון. כדאי לנסות עכשיו.

דיווח על התנהלות פוגעת

דיווח על סרטון שמכיל תוכן פוגעני. כדאי לנסות עכשיו.

ייצוג משאבים

מבנה ה-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
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "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
  },
  "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 החוקיים, מלבד < ו->.
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 – הגרסה ברזולוציה הגבוהה ביותר של התמונה הממוזערת. גודל התמונה הזה זמין לסרטונים מסוימים ולמשאבים אחרים הקשורים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. התמונה ברוחב 1280 פיקסלים ובגובה של 720 פיקסלים.
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 שמשויכת לסרטון. חובה להגדיר ערך לנכס הזה אם מבצעים קריאה ל-method videos.update ומעדכנים את החלק snippet של משאב video.
snippet.liveBroadcastContent	string מציין אם הסרטון הוא שידור חי/פעיל בקרוב. לחלופין, הערך 'ללא' אם הסרטון לא משודר בקרוב או פעיל. הערכים החוקיים לנכס הזה הם: 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 על ידי הרשות האוסטרלית לתקשורת ומדיה. התוכניות האלה מיועדות לילדים (לא לילדים בגילאי הגן) מתחת לגיל 14. acbE - ה acbG - G acbM עד מיליון acbMa15plus עד MA15 ומעלה acbP – תוכניות שקיבלו סיווג P על ידי הרשות האוסטרלית לתקשורת ומדיה. התוכניות האלה מיועדות לילדים בגילאי הגן. acbPg - PG acbR18plus עד R18 + acbUnrated
contentDetails.contentRating.agcomRating	string הדירוג של הסרטון מ-Autorità של איטליה לכל le Garanzie nelle Comunicazioni (AGCOM). הערכים החוקיים לנכס הזה הם: agcomT עד T agcomUnrated agcomVm14 – VM14 agcomVm18 – VM18
contentDetails.contentRating.anatelRating	string דירוג ה-Anatel (Asociación Nacional de Telavisión) של הסרטון בטלוויזיה צ'יליאנית. הערכים החוקיים לנכס הזה הם: anatelA עד A anatelF עד F anatelI – אני anatelI10 – I-10 anatelI12 – I-12 anatelI7 – I-7 anatelR עד ימין 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 - ה 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 עד A cbfcS עד שבת cbfcU עד U cbfcUnrated cbfcUA – U/A cbfcUA7plus – U/A cbfcUA13plus – U/A cbfcUA16plus – U/A
contentDetails.contentRating.cccRating	string הדירוג של הסרטון לפי Consejo de Calificación Syntográfica (צ'ילה). הערכים החוקיים לנכס הזה הם: ccc14 עד 14 ומעלה ccc18 עד 18 ומעלה ccc18s – מעל 18 – פורנוגרפיה ccc18v – גיל 18 ומעלה – Contenido excesivamente fineo ccc6 – 6 ומעלה – Inconveniente para menores de 7 años cccTe – מבט מקרוב על Todo 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 הדירוג של הסרטון הביתי הקנדי (CHVRS) של הסרטון. הערכים החוקיים לנכס הזה הם: chvrs14a עד 14A chvrs18a עד 18A chvrsE - ה chvrsG - G chvrsPg - PG chvrsR עד ימין chvrsUnrated
contentDetails.contentRating.cicfRating	string דירוג הסרטון מטעם Commission de Contrôle des Films (בלגיה). הערכים החוקיים לנכס הזה הם: cicfE - ה 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 מערכת הסיווג בצרפת – הנציבות לסיווג קולנוע הערכים החוקיים לנכס הזה הם: cnc10 עד 10 cnc12 עד 12 cnc16 עד 16 cnc18 עד 18 cncE - ה 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 Class des movies (CSCF) של לוקסמבורג. הערכים החוקיים לנכס הזה הם: cscf12 עד 12 cscf16 עד 16 cscf18 עד 18 cscf6 עד 6 9-cscf9 cscfA עד A cscfAl – אלבמה cscfUnrated
contentDetails.contentRating.czfilmRating	string סיווג הסרטון בצ'כיה. הערכים החוקיים לנכס הזה הם: czfilm12 עד 12 czfilm14 עד 14 czfilm18 עד 18 czfilmU עד U czfilmUnrated
contentDetails.contentRating.djctqRating	string הדירוג של הסרטון ב-Ministryamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – ברזיל). הערכים החוקיים לנכס הזה הם: djctq10 עד 10 djctq12 עד 12 djctq14 עד 14 djctq16 עד 16 djctq18 עד 18 djctqL עד שמאל 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 עד 6א ecbmct6plus עד 6 ecbmct10a עד 10A ecbmct10plus עד 10+ ecbmct16plus עד 16 ומעלה
contentDetails.contentRating.eefilmRating	string הדירוג של הסרטון באסטוניה. הערכים החוקיים לנכס הזה הם: eefilmK12 עד גן חובה עד י"ב eefilmK14 עד K-14 eefilmK16 עד K-16 eefilmK6 - K-6 eefilmL עד שמאל 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 – אני fcoIi - 2 fcoIia – IIA fcoIib – IIB fcoIii - 3 fcoUnrated
contentDetails.contentRating.fmocRating	string הנכס הזה הוצא משימוש ב-2 בנובמבר 2015. צריך להשתמש בנכס contentDetails.contentRating.cncRating במקום זאת. דירוג הסרטון 'Central du cinéma et de l'image animé' (משרד התרבות הצרפתית). הערכים החוקיים לנכס הזה הם: fmoc10 עד 10 fmoc12 עד 12 fmoc16 עד 16 fmoc18 עד 18 fmocE - ה 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 XX עד fpbXx
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 - ה grfilmK עד K grfilmK12 עד גן חובה עד י"ב grfilmK13 עד K-13 grfilmK15 עד K-15 grfilmK17 עד K-17 grfilmK18 עד K-18 grfilmUnrated
contentDetails.contentRating.icaaRating	string הדירוג של הסרטון ב-Instituto de la Filmtografí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 דירוג ה-INAA של הסרטון (Instituto Nacional de Cine y Artes Audiovisuales – ארגנטינה) של הסרטון. הערכים החוקיים לנכס הזה הם: incaaAtp – ATP (Apta para todo publico) incaaC – X (Solo apta para Mayores de 18 años, de exhibición condicionada) 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 סיווג הסרטון מהמועצה לסיווג סרטים בקניה. הערכים החוקיים לנכס הזה הם: kfcb16plus עד 16 kfcbG – GE kfcbPg - PG kfcbR עד 18 kfcbUnrated
contentDetails.contentRating.kijkwijzerRating	string voor de Classificatie van Audiovisuele Media (הולנד). הערכים החוקיים לנכס הזה הם: kijkwijzer12 עד 12 kijkwijzer14 עד 14 kijkwijzer16 עד 16 kijkwijzer18 עד 18 kijkwijzer6 עד 6 9-kijkwijzer9 kijkwijzerAl – אלבמה kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string דירוג המועצה לדירוג מדיה של קוריאה (영상물す위าร). תקן KMRB מדרג סרטונים בדרום קוריאה. הערכים החוקיים לנכס הזה הם: kmrb12plus – 12세 䃁 람苯 kmrb15plus – 15세 המשך상 람다 kmrbAll – 체람ย kmrbR – 청소년 람불다 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string סיווג הסרטון מסרט החיישנים של Lembaga באינדונזיה. הערכים החוקיים לנכס הזה הם: lsf13 עד 13 lsf17 עד 17 lsf21 עד 21 lsfA עד A lsfBo – BO lsfD - יום lsfR עד ימין lsfSu – דרום lsfUnrated
contentDetails.contentRating.mccaaRating	string סיווג הסרטון מהמועצה לסיווג גילים של סרטים של מלטה. הערכים החוקיים לנכס הזה הם: 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) של המכון הדני לקולנוע (Det Danske Filminstitut). הערכים החוקיים לנכס הזה הם: mccyp11 עד 11 mccyp15 עד 15 mccyp7 עד 7 mccypA עד A 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, רשות המדיה הנורווגית (Norwegian Media Authority). הערכים החוקיים לנכס הזה הם: medietilsynet11 עד 11 medietilsynet12 עד 12 medietilsynet15 עד 15 medietilsynet18 עד 18 medietilsynet6 עד 6 medietilsynet7 עד 7 9-medietilsynet9 medietilsynetA עד A medietilsynetUnrated
contentDetails.contentRating.mekuRating	string דירוג הסרטון התקבל מהמכון האודיו-ויזואלי הלאומי (Kansallinen Audiovisualinen Instituutti) בפינלנד. הערכים החוקיים לנכס הזה הם: meku12 עד 12 meku16 עד 16 meku18 עד 18 meku7 עד 7 mekuS עד שבת 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 - ה mocT עד T mocUnrated mocX עד X
contentDetails.contentRating.moctwRating	string הדירוג של הסרטון ממשרד התרבות של טייוואן ((Outline 部). הערכים החוקיים לנכס הזה הם: moctwG - G moctwP עד P moctwPg - PG moctwR עד ימין moctwR12 – R-12 moctwR15 עד R-15 moctwUnrated
contentDetails.contentRating.mpaaRating	string הדירוג של הסרטון Motion Picture Association of America (MPAA). הערכים החוקיים לנכס הזה הם: mpaaG - G mpaaNc17 עד NC-17 mpaaPg - PG mpaaPg13 – PG-13 mpaaR עד ימין mpaaUnrated
contentDetails.contentRating.mpaatRating	string הדירוג של The Motion Picture Association of America לטריילרים של סרטים ולתצוגה מקדימה של סרטים. הערכים החוקיים לנכס הזה הם: mpaatGb – GB (רצועה ירוקה – מאושר לכל הקהלים) mpaatRb – RB (רצועה אדומה – מומלץ לגילאי 17 ומעלה)
contentDetails.contentRating.mtrcbRating	string הדירוג של הסרטון מהמועצה לסיווג סרטים ותוכניות טלוויזיה (הפיליפינים). הערכים החוקיים לנכס הזה הם: 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 - יום 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 סיווג הסרטון ממרכז הסרטים הלאומי של לטביה (מרכז הסרטים הלאומי של לטביה). הערכים החוקיים לנכס הזה הם: nkclv12plus עד 12 ומעלה nkclv18plus עד 18 ומעלה nkclv7plus עד 7 nkclvU עד U nkclvUnrated
contentDetails.contentRating.oflcRating	string הדירוג של הסרטון לסיווג סרטים וספרות (OFLC – ניו זילנד). הערכים החוקיים לנכס הזה הם: oflcG - G oflcM עד מיליון oflcPg - PG oflcR13 עד R13 oflcR15 עד R15 oflcR16 עד R16 oflcR18 עד R18 oflcRp13 עד RP13 oflcRp16 עד 16 RP 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 - ה resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string הדירוג של הסרטון שהנהלה הכללית לרדיו, לטלוויזיה ולקולנוע (מקסיקו) קיבל. הערכים החוקיים לנכס הזה הם: rtcA עד A rtcAa עד AA rtcB - B rtcB15 עד B15 rtcC עד C rtcD - יום rtcUnrated
contentDetails.contentRating.rteRating	string דירוג הסרטון על ידי Raidió Teilifís Eireann באירלנד. הערכים החוקיים לנכס הזה הם: rteCh עד שווייץ rteGa – GA rteMa - מסצ'וסטס 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 עד שמאל smaisUnrated
contentDetails.contentRating.smsaRating	string הדירוג של הסרטון מ-Statens medieród (מועצת המדיה הלאומית של שוודיה) הערכים החוקיים לנכס הזה הם: smsa11 עד 11 smsa15 עד 15 smsa7 עד 7 smsaA – כל הגילאים smsaUnrated
contentDetails.contentRating.tvpgRating	string הסיווג של הסרטון לפי הנחיות להורים לגבי טלוויזיה (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 סטטוס הפרטיות של הסרטון. הערכים החוקיים לנכס הזה הם: private public unlisted
status.publishAt	datetime התאריך והשעה שבהם הסרטון מתוזמן לפרסום. ניתן להגדיר אותה רק אם סטטוס הפרטיות של הסרטון הוא 'פרטי'. הערך מצוין בפורמט ISO 8601. שימו לב לשתי הנקודות הנוספות הבאות לגבי ההתנהגות של הנכס הזה: אם מגדירים את ערך המאפיין הזה בזמן קריאה ל-method videos.update, צריך להגדיר גם את ערך המאפיין status.privacyStatus ל-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.
statistics	object האובייקט statistics מכיל נתונים סטטיסטיים לגבי הסרטון.
statistics.viewCount	unsigned long מספר הצפיות בסרטון.
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 מספר התגובות לסרטון.
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 התחילה להחזיר קבוצה קטנה של מזהי נושאים שנאספו. אלו מזהי נושאים שנתמכים ב-15 בפברואר 2017 נושאים נושאי מוזיקה /m/04rlf מוזיקה (נושא להורים) /m/02mscn מוזיקה נוצרית /m/0ggq0m מוזיקה קלאסית /m/01lyv מדינה /m/02lkt מוזיקה אלקטרונית /m/0glt670 מוזיקת היפ-הופ /m/05rwpb מוזיקה עצמאית /m/03_d0 ג'אז /m/028sqc מוזיקה מאסיה /m/0g293 מוזיקה של אמריקה הלטינית /m/064t9 מוזיקת פופ /m/06cqb רגאיי /m/06j6l רית'ם אנד בלוז /m/06by7 מוזיקת רוק /m/0gywn מוזיקת נשמה נושאי משחקים /m/0bzvm2 גיימינג (נושא להורים) /m/025zzc משחק פעולה /m/02ntfj משחק פעולה והרפתקאות /m/0b1vjn משחק לקהל הרחב /m/02hygl משחק וידאו מוזיקלי /m/04q1x3q משחק וידאו חשיבה /m/01sjng משחק וידאו מירוצים /m/0403l3g משחק וידאו עם תפקידים /m/021bp2 משחק הדמיה /m/022dc6 משחק ספורט /m/03hf_rm משחק וידאו אסטרטגיה נושאי ספורט /m/06ntj ספורט (נושא להורים) /m/0jm_ פוטבול אמריקאי /m/018jz בייסבול /m/018w8 כדורסל /m/01cgz איגרוף /m/09xp_ קריקט /m/02vx4 פוטבול /m/037hz גולף /m/03tmr הוקי קרח /m/01h7lh אומנויות לחימה משולבות /m/0410tth ספורט מוטורי /m/07bs0 טניס /m/07_53 כדורעף נושאי בידור /m/02jjt בידור (נושא להורים) /m/09kqc הומור /m/02vxn סרטים /m/05qjc אומנויות הבמה /m/066wd היאבקות מקצועית /m/0f2f9 תוכניות טלוויזיה נושאי סגנון חיים /m/019_rr סגנון חיים (נושא להורים) /m/032tl אופנה /m/027x7n כושר גופני /m/02wbm אוכל /m/03glg תחביב /m/068hy חיות מחמד /m/041xxh אטרקטיביות פיזית [יופי] /m/07c1v טכנולוגיה /m/07bxq תיירות /m/07yv9 רכבים נושאים חברתיים /m/098wr חברה (נושא להורים) /m/09s1f עסקים /m/0kt51 בריאות /m/01h6rj צבא /m/05qt0 פוליטיקה /m/06bvp דת נושאים אחרים /m/01k8wb ידע
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 קצב הפריימים של שידור הווידאו, ביחידות של פריימים לשנייה.
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 – עיבוד הסרטון נכשל. למידע נוסף, ניתן לעיין בסיבות לאי-העיבוד. processing – הסרטון בתהליך עיבוד. הצגת ההתקדמות בתהליך. 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 מעבדת בפועל את קובץ הסרטון שהועלה. בנוסף, מתבצע זיהוי של בעיות שלא בהכרח מצביעות על כך שעיבוד הווידאו ייכשל, אבל עדיין עלולות לגרום לבעיות כמו בעיות בסנכרון, פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) של הסרטון או טראק של אודיו חסר. הערכים החוקיים לנכס הזה הם: 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 המזהה של הצ'אט בשידור חי שמצורף לסרטון הזה ופעיל כרגע. יש למלא את השדה הזה רק אם הסרטון הוא כרגע שידור חי שכולל צ'אט בשידור חי. לאחר שהעברות השידור להשלמת השדה הזה יוסרו והצ'אט בשידור חי ייסגר. בשידורים קבועים, מזהה הצ'אט בשידור חי לא יהיה מקושר יותר לסרטון הזה אלא לסרטון החדש שמוצג בדף הקבוע.
localizations	object האובייקט localizations מכיל תרגומים של המטא-נתונים של הסרטון.
localizations.(key)	object השפה של הטקסט המותאם לשוק המקומי שמשויך לערך המפתח. הערך הוא מחרוזת שמכילה את קוד השפה BCP-47.
localizations.(key).title	string שם הסרטון המותאם לשוק המקומי.
localizations.(key).description	string תיאור הסרטון המותאם לשוק המקומי.