Videos

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

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

שיטות

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

getRating

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

list

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

הוספה

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

עדכון

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

מחיקה

מחיקת סרטון ב-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
  },
  "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 ה-e של המשאב הזה.
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 – הגרסה ברזולוציה הגבוהה ביותר של התמונה הממוזערת. גודל התמונה הזה זמין לסרטונים מסוימים ולמשאבים אחרים שמתייחסים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. הרוחב של התמונה הזו הוא 1,280 פיקסלים וגובה של 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 המשויכת לסרטון. צריך להגדיר ערך למאפיין הזה אם קוראים לשיטה 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) או של הרשות האוסטרלית לתקשורת ומדיה (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 - א anatelF עד F anatelI - 1 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 - מז' bfvcG עד G bfvcUnrated
contentDetails.contentRating.bmukkRating	string דירוג הסרטון על ידי הוועדה האוסטרית לסיווג מדיה (Bundesministerium für Unterribt, 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 Movies Certification (CBFC – הודו). הערכים החוקיים לנכס הזה הם: cbfcA - א cbfcS - דר' cbfcU - U cbfcUnrated cbfcUA – U/A cbfcUA7plus – U/A cbfcUA13plus – U/A cbfcUA16plus – U/A
contentDetails.contentRating.cccRating	string הדירוג של הסרטון בקונסחו דה Calificación Syntográpica (צ'ילה). הערכים החוקיים לנכס הזה הם: ccc14 עד 14 ומעלה ccc18 עד 18 ומעלה ccc18s – 18 ומעלה – Contenido pornográfico ccc18v – 18 ומעלה – Contenido exsivamente לצאת 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 דירוג הסרטון בשווייץ. הערכים החוקיים לנכס הזה הם: 0-chfilm0 chfilm12 עד 12 chfilm16 עד 16 chfilm18 עד 18 chfilm6 עד 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string הדירוג של הסרטון הביתי של הסרטון הקנדי (CHVRS). הערכים החוקיים לנכס הזה הם: chvrs14a עד 14A chvrs18a עד 18A chvrsE - מז' chvrsG עד G chvrsPg – PG chvrsR עד R chvrsUnrated
contentDetails.contentRating.cicfRating	string סיווג הסרטון על ידי Commission de Contrôle des Movies (בלגיה). הערכים החוקיים לנכס הזה הם: 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 cscf9 עד 9 cscfA - א cscfAl – אלבמה cscfUnrated
contentDetails.contentRating.czfilmRating	string סיווג הסרטון בצ'כיה. הערכים החוקיים לנכס הזה הם: czfilm12 עד 12 czfilm14 עד 14 czfilm18 עד 18 czfilmU - U czfilmUnrated
contentDetails.contentRating.djctqRating	string הדירוג של הסרטון לפי מחלקה 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 עד 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 עד ל' 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 - 1 fcoIi - 2 fcoIia – IIA fcoIib - IIB fcoIii - III fcoUnrated
contentDetails.contentRating.fmocRating	string הנכס הזה הוצא משימוש ב-2 בנובמבר 2015. במקום זאת, צריך להשתמש בנכס contentDetails.contentRating.cncRating. הדירוג של הסרטון ב-Center National 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 - א fpbPg – PG fpbUnrated fpbX18 - X18 XX עד fpbXx
contentDetails.contentRating.fpbRatingReasons[]	list סיבות שמסבירות למה הסרטון קיבל את סיווג FPB (דרום אפריקה).
contentDetails.contentRating.fskRating	string הדירוג של הסרטון ב-Freiwillige Selbstkontrolle der Foilwirtschaft (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 – K-12 grfilmK13 – K-13 grfilmK15 – K-15 grfilmK17 – K-17 grfilmK18 – K-18 grfilmUnrated
contentDetails.contentRating.icaaRating	string הדירוג של הסרטון ב-Instituto de la Formattografí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 (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 kijkwijzer9 עד 9 kijkwijzerAl – אלבמה kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string דירוג הוועדה לדירוג מדיה של קוריאה (Association of Korea Rating Board (Association) להגדרת היא ועוד: דירוג הסרטונים על ידי KMRB בדרום קוריאה. הערכים החוקיים לנכס הזה הם: kmrb12plus – 12ℸ 䃁 ’㞌換 kmrb15plus – 15ℸ 䃁 ɞ kmrbAll – 多溴貴換鞌る kmrbR – ⲭ膌 ’⬞消を kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string סיווג הסרטון מתוך סרט חיישן Lembaga של אינדונזיה. הערכים החוקיים לנכס הזה הם: lsf13 עד 13 lsf17 עד 17 lsf21 עד 21 lsfA - א lsfBo – BO lsfD עד יום lsfR עד R 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 Fiberinstitut) (Det Danske Fiberinstitut) (Det Danske Footinstitut) היא מועצת המדיה לילדים ולצעירים. הערכים החוקיים לנכס הזה הם: mccyp11 עד 11 mccyp15 עד 15 mccyp7 עד 7 mccypA - א mccypUnrated
contentDetails.contentRating.mcstRating	string מערכת הסיווג של הסרטון בווייטנאם – MCST הערכים החוקיים לנכס הזה הם: 0-mcst0 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 - דר' mekuUnrated
contentDetails.contentRating.mibacRating	string סיווג הסרטון מ-Ministero dei Beni e delle Attività Culturei 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 הדירוג של הסרטון ממשרד התרבות של טייוואן ((文中部). הערכים החוקיים לנכס הזה הם: moctwG עד G moctwP עד P moctwPg – PG moctwR עד R 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 עד R 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 עד 18R nbcG עד G nbcPg – PG nbcPu – PU nbcUnrated
contentDetails.contentRating.nfrcRating	string סיווג הסרטון ממרכז הסרטים הלאומי הבולגרי. הערכים החוקיים לנכס הזה הם: nfrcA - א 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 סיווג הסרטון מ-Nacionנאlais Kino centrs (מרכז הסרטים הלאומי של לטביה). הערכים החוקיים לנכס הזה הם: 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 - א resorteviolenciaB - B resorteviolenciaC עד C resorteviolenciaD עד יום resorteviolenciaE - מז' resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string הדירוג של הסרטון בהנהלה הכללית של רדיו, טלוויזיה וסינמטוגרפיה (מקסיקו). הערכים החוקיים לנכס הזה הם: rtcA - א rtcAa – AA rtcB - B rtcB15 עד B15 rtcC עד C rtcD עד יום rtcUnrated
contentDetails.contentRating.rteRating	string סיווג הסרטון על ידי Raidió Teilifís Eireann באירלנד. הערכים החוקיים לנכס הזה הם: rteCh – שווייץ rteGa – Google Analytics 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 עד ל' smaisUnrated
contentDetails.contentRating.smsaRating	string הדירוג של הסרטון מ-Statens medierãod (מועצת המדיה הלאומית של שוודיה). הערכים החוקיים לנכס הזה הם: 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. שים לב לשתי הנקודות הנוספות הבאות בנוגע להתנהגות של נכס זה: אם מגדירים את הערך של המאפיין הזה כשמפעילים את השיטה 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. התמיכה ב-API תתבצע עד 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 תיאור הסרטון המותאם לשוק המקומי.