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,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "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 – גרסת הרזולוציה הגבוהה ביותר של התמונה הממוזערת. גודל התמונה הזה זמין לסרטונים מסוימים ולמשאבים אחרים שמפנים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. התמונה הזו ברוחב 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 שמשויכת לסרטון. צריך להגדיר ערך למאפיין הזה אם קוראים ל-method videos.update ומעדכנים את החלק snippet במשאב video.
snippet.liveBroadcastContent	string מציין אם הסרטון הוא שידור חי שמשודר עכשיו או שישודר בקרוב. לחלופין, הערך הוא 'none' אם הסרטון הוא לא שידור חי פעיל או שידור חי שעומד להתקיים. הערכים התקפים לנכס הזה הם: live none upcoming
snippet.defaultLanguage	string השפה של הטקסט במאפיינים snippet.title ו-snippet.description של המשאב video.
snippet.localized	object האובייקט snippet.localized מכיל שם ותיאור מותאמים לסרטון או את השם בשפת ברירת המחדל של המטא-נתונים של הסרטון. טקסט מותאם לשפה המקומית מוחזר בקטע הקוד של המשאב אם בבקשה videos.list נעשה שימוש בפרמטר hl כדי לציין שפה שבה צריך להחזיר טקסט מותאם לשפה המקומית וגם אם טקסט מותאם לשפה המקומית זמין בשפה הזו. המטא-נתונים של שפת ברירת המחדל מוחזרים אם לא צוין ערך של הפרמטר hl או אם צוין ערך אבל אין מטא-נתונים מותאמים לשוק המקומי בשפה שצוינה. המאפיין מכיל ערך לקריאה בלבד. משתמשים באובייקט localizations כדי להוסיף, לעדכן או למחוק שמות מתורגמים.
snippet.localized.title	string שם הסרטון המתורגם.
snippet.localized.description	string תיאור הסרטון המותאם לשוק המקומי.
snippet.defaultAudioLanguage	string המאפיין default_audio_language מציין את השפה המדוברת ברצועת האודיו שמוגדרת כברירת מחדל בסרטון.
contentDetails	object האובייקט contentDetails מכיל מידע על תוכן הסרטון, כולל משך הסרטון והערה לגבי זמינות הכתוביות בסרטון.
contentDetails.duration	string אורך הסרטון. ערך המאפיין הוא משך זמן לפי תקן ISO 8601. לדוגמה, בסרטון באורך של דקה אחת לפחות ופחות משעה, משך הזמן מוצג בפורמט PT#M#S, שבו האותיות PT מציינות שהערך מציין פרק זמן, והאותיות M ו-S מתייחסות לאורך הסרטון בדקות ובשניות, בהתאמה. התווים # שמופיעים לפני האותיות M ו-S הם מספרים שלמים שמציינים את מספר הדקות (או השניות) של הסרטון. לדוגמה, ערך של PT15M33S מציין שהסרטון הוא 15 דקות ו-33 שניות. אם הסרטון נמשך שעה אחת לפחות, משך הזמן מצוין בפורמט PT#H#M#S, כאשר המספר # שמופיע לפני האות H מציין את משך הסרטון בשעות, וכל שאר הפרטים זהים כפי שמתואר למעלה. אם הסרטון נמשך לפחות יום אחד, האותיות P ו-T מופרדות והפורמט של הערך הוא P#DT#H#M#S. פרטים מלאים זמינים במפרט ISO 8601.
contentDetails.dimension	string מציין אם הסרטון זמין בתלת-ממד או בדו-ממד.
contentDetails.definition	string מציין אם הסרטון זמין באיכות גבוהה (HD) או רק באיכות רגילה. הערכים התקפים של המאפיין הזה הם: hd sd
contentDetails.caption	string מציין אם יש כתוביות לסרטון. הערכים החוקיים לנכס הזה הם: false true
contentDetails.licensedContent	boolean מציין אם הסרטון מייצג תוכן ברישיון. כלומר, התוכן הועלה לערוץ שמקושר לשותף תוכן של YouTube, והשותף הזה הצהיר על זכויות יוצרים לגביו.
contentDetails.regionRestriction	object האובייקט regionRestriction מכיל מידע על המדינות שבהן אפשר לצפות בסרטון (או שלא). האובייקט יכיל את המאפיין contentDetails.regionRestriction.allowed או את המאפיין contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[]	list רשימה של קודי אזורים שמזהים את המדינות שבהן אפשר לצפות בסרטון. אם המאפיין הזה קיים ומדינה מסוימת לא רשומה בערך שלו, הסרטון ייחסם ולא יוצג במדינה הזו. אם המאפיין הזה קיים ומכיל רשימה ריקה, הסרטון ייחסם בכל המדינות.
contentDetails.regionRestriction.blocked[]	list רשימה של קודי אזורים שמזהים מדינות שבהן הסרטון חסום. אם המאפיין הזה קיים ומדינה מסוימת לא רשומה בערך שלו, המשמעות היא שאפשר לצפות בסרטון במדינה הזו. אם המאפיין הזה קיים ומכיל רשימה ריקה, הסרטון יהיה גלוי בכל המדינות.
contentDetails.contentRating	object מציין את הדירוגים שהסרטון קיבל לפי שיטות דירוג שונות.
contentDetails.contentRating.acbRating	string הדירוג של המועצה האוסטרלית לסיווג (ACB) של הסרטון או הרשות האוסטרלית לתקשורת ומדיה (ACMA). דירוגים של ACMA משמשים לסיווג תוכניות טלוויזיה לילדים. הערכים החוקיים למאפיין הזה הם: acbC – תוכניות שקיבלו סיווג C על ידי הרשות האוסטרלית לתקשורת ומדיה. התוכניות האלה מיועדות לילדים (לא לילדים בגילאי הגן) מתחת לגיל 14. acbE – E acbG – G acbM – M acbMa15plus – MA15+‎ acbP – תוכניות שקיבלו סיווג P מהרשות האוסטרלית לתקשורת ומדיה. התוכניות האלה מיועדות לילדים בגילאי הגן. acbPg – PG acbR18plus – R18+‎ acbUnrated
contentDetails.contentRating.agcomRating	string דירוג הסרטון מ-Autorità לפי le Garanzie nelle Comunicazioni (AGCOM). הערכים החוקיים לנכס הזה הם: agcomT – טון agcomUnrated agcomVm14 – VM14 agcomVm18 – VM18
contentDetails.contentRating.anatelRating	string דירוג Anatel (Asociación Nacional de Televisión) של הסרטון בטלוויזיה בצ'ילה. הערכים החוקיים לנכס הזה הם: anatelA עד A anatelF – F anatelI – I anatelI10 – I-10 anatelI12 – I-12 anatelI7 – I-7 anatelR עד R anatelUnrated
contentDetails.contentRating.bbfcRating	string הסיווג של הסרטון על ידי המועצה הבריטית לסיווג סרטים (BBFC). הערכים התקפים למאפיין הזה הם: bbfc12 – 12 bbfc12a עד 12A bbfc15 עד 15 bbfc18 – 18 bbfcPg – PG bbfcR18 – R18 bbfcU עד U bbfcUnrated
contentDetails.contentRating.bfvcRating	string דירוג הסרטון על ידי מועצת צנזור הווידאו והקול בתאילנד. הערכים החוקיים לנכס הזה הם: bfvc13 – 13 bfvc15 – 15 bfvc18 – 18 bfvc20 – 20 bfvcB – B bfvcE – E bfvcG – G bfvcUnrated
contentDetails.contentRating.bmukkRating	string הדירוג של הסרטון על ידי ועדת הסיווג של המדיה באוסטריה (Bundesministerium für Unterricht, Kunst und Kultur). הערכים התקפים למאפיין הזה הם: bmukk10 – 10+ bmukk12 – 12+ bmukk14 - 14 ומעלה bmukk16 – מגיל 16 ומעלה bmukk6 – 6+ bmukk8 - 8 ומעלה bmukkAa – ללא הגבלה bmukkUnrated
contentDetails.contentRating.catvRating	string מערכת סיווג לטלוויזיה בקנדה – מערכת סיווג הטלוויזיה בקנדה. דירוג הסרטון של ועדת הרדיו, הטלוויזיה והטלקומוניקציות בקנדה (CRTC) לשידורים בקנדה בשפה האנגלית. מידע נוסף זמין באתר של Canadian Broadcast Standards Council. הערכים התקינים של המאפיין הזה הם: catv14plus – מגיל 14 ומעלה catv18plus – מעל גיל 18 catvC – C catvC8 – C8 catvG – G catvPg – PG catvUnrated
contentDetails.contentRating.catvfrRating	string הסיווג של הסרטון מטעם Canadian Radio-Television and Telecommunications Commission ‏(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 Cinematográfica (צ'ילה) של הסרטון. הערכים החוקיים לנכס הזה הם: ccc14 – מגיל 14 ומעלה ccc18 - 18 ומעלה ccc18s – 18 ומעלה – contenido pornográfico ccc18v – 18+ - contenido excesivamente violento ccc6 – 6+ - Inconveniente para menores de 7 años cccTe – משימות לביצוע 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 Films (בלגיה). הערכים החוקיים לנכס הזה הם: cicfE – E cicfKntEna – KNT/ENA cicfKtEa – ק"ט/יחידה cicfUnrated
contentDetails.contentRating.cnaRating	string דירוג הסרטון מ-CONSILIUL NATIONAL AL AUDIOVIZUALULUI ברומניה. הערכים החוקיים לנכס הזה הם: cna12 – 12 cna15 – 15 cna18 – 18 cna18plus – מעל גיל 18 cnaAp – AP cnaUnrated
contentDetails.contentRating.cncRating	string מערכת הסיווג בצרפת – נציבות הסיווג של הקולנוע ב-Cinetographique הערכים החוקיים לנכס הזה הם: cnc10 – 10 cnc12 – 12 cnc16 – 16 cnc18 – 18 cncE – E cncT – טון cncUnrated
contentDetails.contentRating.csaRating	string הדירוג של הסרטון על ידי Conseil supérieur de l'audiovisuel (המועצה העליונה לטלוויזיה ולרדיו) בצרפת, שמדרגת תוכן שידור. הערכים התקפים למאפיין הזה הם: csa10 – 10 csa12 – 12 csa16 – 16 csa18 עד 18 csaInterdiction – חסימת נתונים csaT – טון csaUnrated
contentDetails.contentRating.cscfRating	string דירוג הסרטון על ידי Commission de surveillance de la category des Films (CSCF) של לוקסמבורג. הערכים החוקיים לנכס הזה הם: cscf12 עד 12 cscf16 עד 16 cscf18 – 18 cscf6 עד 6 cscf9 – 9 cscfA – A cscfAl – AL cscfUnrated
contentDetails.contentRating.czfilmRating	string הדירוג של הסרטון בצ'כיה. הערכים התקינים למאפיין הזה הם: czfilm12 – 12 czfilm14 – 14 czfilm18 – 18 czfilmU – U czfilmUnrated
contentDetails.contentRating.djctqRating	string הדירוג של הסרטון לפי Departamento de Justiça, Classificação, Qualificação e Títulos‏ (DJCQT – ברזיל). הערכים התקפים של המאפיין הזה הם: 10-djctq10 djctq12 – 12 djctq14 – 14 djctq16 – 16 djctq18 – 18 djctqL עד L djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list הסיבות לכך שהסרטון קיבל את הדירוג שלו ב-DJCQT (ברזיל).
contentDetails.contentRating.ecbmctRating	string מערכת דירוג בטורקיה – מועצת ההערכה והסיווג של משרד התרבות והתיירות הערכים התקינים של המאפיין הזה הם: ecbmct13a עד 13A ecbmct13plus – 13 ומעלה ecbmct15a עד 15A ecbmct15plus – 15 ומעלה ecbmct18plus – מעל גיל 18 ecbmct7a – 7A ecbmct7plus - 7 ומעלה ecbmctG – G ecbmctUnrated ecbmct6a עד 6A ecbmct6plus – 6+ ecbmct10a – 10A ecbmct10plus – 10+ ecbmct16plus – מגיל 16 ומעלה
contentDetails.contentRating.eefilmRating	string הדירוג של הסרטון באסטוניה. הערכים התקינים למאפיין הזה הם: eefilmK12 - K-12 eefilmK14 – K-14 eefilmK16 – K-16 eefilmK6 – גן ילדים עד כיתה ו' eefilmL – L eefilmMs12 – MS-12 eefilmMs6 – MS-6 eefilmPere – Pere 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 עד 18:00 fcbm18pl – 18PL fcbm18sg – 18SG fcbm18sx – 18SX fcbmP12 עד P12 fcbmP13 – P13 fcbmPg13 – PG13 fcbmU – U fcbmUnrated
contentDetails.contentRating.fcoRating	string הסיווג של הסרטון על ידי המשרד לניהול סרטים, עיתונים ומאמרים בהונג קונג. הערכים התקפים למאפיין הזה הם: fcoI – I fcoIi עד II fcoIia – IIA fcoIib – IIB fcoIii – III fcoUnrated
contentDetails.contentRating.fmocRating	string הנכס הזה יצא משימוש ב-2 בנובמבר 2015. במקום זאת, יש להשתמש במאפיין contentDetails.contentRating.cncRating. דירוג הסרטון של Centre national du cinéma et de l'image animé (משרד התרבות הצרפתי). הערכים החוקיים של המאפיין הזה הם: 10-fmoc10 fmoc12 עד 12 fmoc16 עד 16 fmoc18 – 18 fmocE – E fmocU – U fmocUnrated
contentDetails.contentRating.fpbRating	string הסיווג של הסרטון על ידי Film and Publication Board (הרשות לקולנוע ולפרסום) בדרום אפריקה. הערכים החוקיים למאפיין הזה הם: 10-fpb10 fpb1012Pg – 10-12PG fpb13 עד 13 fpb16 – 16 fpb18 – 18 fpb79Pg – 7-9PG fpbA עד A fpbPg – PG fpbUnrated fpbX18 – X18 fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[]	list סיבות שמסבירות למה הסרטון קיבל את הדירוג שלו ב-FPB (דרום אפריקה).
contentDetails.contentRating.fskRating	string הסיווג של הסרטון לפי Freiwillige Selbstkontrolle der Filmwirtschaft‏ (FSK – גרמניה). הערכים החוקיים למאפיין הזה הם: fsk0 – FSK 0 fsk12 – FSK 12 fsk16 – FSK 16 fsk18 – FSK 18 fsk6 – FSK 6 fskUnrated
contentDetails.contentRating.grfilmRating	string דירוג הסרטון ביוון. הערכים החוקיים לנכס הזה הם: grfilmE עד מז' grfilmK - K grfilmK12 – K-12 grfilmK13 - K-13 grfilmK15 – K-15 grfilmK17 – K-17 grfilmK18 – K-18 grfilmUnrated
contentDetails.contentRating.icaaRating	string הדירוג של הסרטון לפי Instituto de la Cinematografía y de las Artes Audiovisuales‏ (ICAA – ספרד). הערכים התקפים למאפיין הזה הם: icaa12 – 12 icaa13 – 13 icaa16 עד 16 icaa18 – 18 icaa7 – 7 icaaApta – APTA icaaUnrated icaaX – X
contentDetails.contentRating.ifcoRating	string הסיווג של הסרטון על ידי Irish Film Classification Office‏ (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 - Argentina) של הסרטון. הערכים החוקיים לנכס הזה הם: 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 – AL kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string הדירוג של הסרטון על ידי Korea Media Rating Board‏ (영상물등급위원회). ה-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 עד R lsfSu – SU 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). הערכים התקפים של המאפיין הזה הם: mccyp11 – 11 mccyp15 – 15 mccyp7 – 7 mccypA – A 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 – A medietilsynetUnrated
contentDetails.contentRating.mekuRating	string דירוג הסרטון מטעם Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute) בפינלנד). הערכים החוקיים לנכס הזה הם: meku12 עד 12 meku16 עד 16 meku18 – 18 7-meku7 mekuS – S mekuUnrated
contentDetails.contentRating.mibacRating	string הדירוג של הסרטון לפי Ministero dei Beni e delle Attività Culturali e del Turismo (איטליה). הערכים התקפים למאפיין הזה הם: mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string הדירוג של הסרטון על ידי Ministerio de Cultura (קולומביה). הערכים התקינים למאפיין הזה הם: moc12 – 12 moc15 – 15 moc18 עד 18 moc7 – 7 mocBanned – אסור mocE עד מז' mocT – טון 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 – הצפייה מתחת לגיל 17 אסורה mpaaPg – PG mpaaPg13 – PG-13 mpaaR – R mpaaUnrated
contentDetails.contentRating.mpaatRating	string הסיווג של Motion Picture Association of America (איגוד הסרטים של אמריקה) לטריילרים ולקטעים מקדימים של סרטים. הערכים החוקיים למאפיין הזה הם: mpaatGb – GB (רצועת ירוק – תוכן שאושר לכל הקהלים) mpaatRb – RB (Red Band – מומלץ לגילאי 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 הדירוג של הסרטון מ-Bulgarian National Film Center. הערכים התקפים למאפיין הזה הם: nfrcA – A nfrcB – B nfrcC – C nfrcD – D nfrcUnrated nfrcX עד X
contentDetails.contentRating.nfvcbRating	string הדירוג של הסרטון על ידי המועצה הלאומית של ניגריה לבקרת סרטים ווידאו. הערכים התקפים למאפיין הזה הם: nfvcb12 – 12 nfvcb12a – 12A nfvcb15 – 15 nfvcb18 – 18 nfvcbG – G nfvcbPg – PG nfvcbRe – RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string הסיווג של הסרטון לפי Nacionãlais Kino centrs (המרכז הלאומי לקולנוע בלטביה). הערכים התקפים למאפיין הזה הם: nkclv12plus – 12+ nkclv18plus – מעל גיל 18 nkclv7plus – 7+ nkclvU – U nkclvUnrated
contentDetails.contentRating.oflcRating	string הדירוג של המשרד לסיווג סרטים וספרות של הסרטון (OFLC – ניו זילנד). הערכים החוקיים לנכס הזה הם: oflcG – G oflcM – M oflcPg – PG oflcR13 עד R13 oflcR15 עד R15 oflcR16 – R16 oflcR18 – R18 oflcRp13 – RP13 oflcRp16 – RP16 oflcUnrated
contentDetails.contentRating.pefilmRating	string דירוג הסרטון בפרו. הערכים החוקיים לנכס הזה הם: pefilm14 – 14 pefilm18 – 18 pefilmPg – PG pefilmPt עד PT pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating	string דירוג הסרטון בוונצואלה. הערכים החוקיים לנכס הזה הם: resorteviolenciaA – A BresorteviolenciaB resorteviolenciaC – C resorteviolenciaD – D resorteviolenciaE – E resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string הדירוג של הסרטון לפי המנהל הכללי של רדיו, טלוויזיה וקולנוע (מקסיקו). הערכים התקפים למאפיין הזה הם: rtcA – A rtcAa – AA rtcB – B rtcB15 – B15 rtcC - C rtcD עד י' rtcUnrated
contentDetails.contentRating.rteRating	string דירוג הסרטון מטעם Raidió Teilifís Éireann שבאירלנד. הערכים החוקיים לנכס הזה הם: rteCh – CH rteGa – GA rteMa – MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string הדירוג של הסרטון במרשם הסרטים הלאומי של הפדרציה הרוסית (MKRF – רוסיה). הערכים התקינים למאפיין הזה הם: russia0 - 0+ russia12 – 12+ russia16 - 16 ומעלה russia18 – מעל גיל 18 russia6 – 6+ russiaUnrated
contentDetails.contentRating.skfilmRating	string הדירוג של הסרטון בסלובקיה. הערכים התקינים למאפיין הזה הם: skfilmG – G skfilmP2 – P2 skfilmP5 – P5 skfilmP8 – P8 skfilmUnrated
contentDetails.contentRating.smaisRating	string הדירוג של הסרטון באיסלנד. הערכים התקינים למאפיין הזה הם: smais12 – 12 smais14 – 14 smais16 – 16 smais18 – 18 7-smais7 smaisL – L smaisUnrated
contentDetails.contentRating.smsaRating	string הדירוג של הסרטון מ-Statens medieråd (מועצת המדיה הלאומית של שוודיה). הערכים התקפים למאפיין הזה הם: 11-smsa11 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.
status.containsSyntheticMedia	boolean בבקשה של videos.insert או videos.update, הנכס הזה מאפשר לבעל הערוץ לחשוף שהסרטון מכיל תוכן ריאליסטי ששונה או סינתטי (A/S). מידע נוסף על כללי המדיניות של YouTube שקשורים לתוכן A/S דוגמאות לתוכן שמכיל קריאה לפעולה כוללות סרטונים שבהם: ליצור תוכן שבו נראה אדם אמיתי שאומר או עושה משהו שהוא לא באמת אמר או עשה בתוכן נעשה שינוי בחומר מצולם של אירוע או מקום אמיתיים יצירת סצנה שנראית אמיתית אבל לא התרחשה באמת
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 מספר התגובות לסרטון.
paidProductPlacementDetails	object האובייקט paidProductPlacementDetails מכיל מידע על שילוב מוצר בתשלום בסרטון.
paidProductPlacementDetails.hasPaidProductPlacement	boolean מגדירים את הערך true אם התוכן כולל שילוב מוצר בתשלום. ברירת המחדל היא false.
player	object האובייקט player מכיל מידע שמשמש להפעלת הסרטון בנגן מוטמע.
player.embedHtml	string תג <iframe> שמטמיע נגן שמפעיל את הסרטון. אם בבקשת ה-API לאחזור המשאב צוין ערך לפרמטר maxHeight ו/או maxWidth, הגודל של הנגן המוטמע יותאם כך שיציג את הווידאו בהתאם לדרישות של maxHeight ו/או maxWidth. אם יחס הגובה-רוחב של הסרטון לא ידוע, ברירת המחדל של הנגן המוטמע היא פורמט 4:3.
player.embedHeight	long הגובה של הנגן המוטמע שמוחזר במאפיין player.embedHtml. המאפיין הזה מוחזר רק אם בבקשה צוין ערך לפרמטרים maxHeight או maxWidth ויחס הגובה-רוחב של הסרטון ידוע.
player.embedWidth	long הרוחב של הנגן המוטמע שמוחזר בנכס player.embedHtml. המערכת מחזירה את המאפיין הזה רק אם בבקשה צוין ערך לפרמטר maxHeight ו/או לפרמטר maxWidth, ויחס הגובה-רוחב של הסרטון ידוע.
topicDetails	object האובייקט topicDetails מכיל מידע על הנושאים שמשויכים לסרטון. חשוב: פרטים נוספים על השינויים הצפויים שקשורים למזהי נושאים מופיעים בהגדרות של המאפיינים topicDetails.relevantTopicIds[] ו-topicDetails.topicIds[], וגם בהיסטוריית הגרסאות.
topicDetails.topicIds[]	list חשוב: המאפיין הזה הוצא משימוש החל מ-10 בנובמבר 2016. ה-API לא מחזיר יותר ערכים לנכס הזה, וכל הנושאים שמשויכים לסרטון מוחזרים עכשיו באמצעות ערך הנכס topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[]	list רשימה של מזהי נושאים שרלוונטיים לסרטון. הנכס הזה הוצא משימוש החל מ-10 בנובמבר 2016. התמיכה בה תהיה זמינה עד 10 בנובמבר 2017. חשוב: עקב ההוצאה משימוש של Freebase ו-Freebase API, החל מ-27 בפברואר 2017 מזהי נושאים התחילו לפעול בצורה שונה. באותו זמן, YouTube התחיל להחזיר קבוצה קטנה של מזהים של נושאים שנבחרו בקפידה. כאן מפורטים מזהי הנושאים הנתמכים החל מ-15 בפברואר 2017 נושאים נושאי מוזיקה /m/04rlf מוזיקה (נושא הורה) /m/02mscn מוזיקה נוצרית /m/0ggq0m מוזיקה קלאסית /m/01lyv מדינה /m/02lkt מוזיקה אלקטרונית /m/0glt670 מוזיקת היפ הופ /m/05rwpb מוזיקה עצמאית /m/03_d0 Jazz /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_ Cricket /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 – עיבוד הסרטון נכשל. מידע נוסף זמין במאמר ProcessingFailureReason. processing – הסרטון בתהליך עיבוד. ראו ProcessingProgress. succeeded – עיבוד הסרטון הסתיים. terminated – פרטי העיבוד לא זמינים יותר.
processingDetails.processingProgress	object האובייקט processingProgress מכיל מידע על ההתקדמות של YouTube בעיבוד הסרטון. הערכים רלוונטיים רק אם סטטוס העיבוד של הסרטון הוא processing.
processingDetails.processingProgress.partsTotal	unsigned long אומדן של המספר הכולל של החלקים שצריך לעבד עבור הסרטון. יכול להיות שהמספר יתעדכן באומדנים מדויקים יותר בזמן שמערכת YouTube מעבדת את הסרטון.
processingDetails.processingProgress.partsProcessed	unsigned long מספר החלקים בסרטון שכבר עברו עיבוד ב-YouTube. כדי להעריך את אחוז הסרטון שמערכת YouTube כבר עיבדה, אפשר לחשב את הנוסחה הבאה: 100 * parts_processed / parts_total הערה: מאחר שמספר החלקים המשוער עשוי לעלות בלי עלייה תואמת במספר החלקים שכבר עברו עיבוד, ייתכן שההתקדמות המחושבת תקטן מדי פעם בזמן שמערכת YouTube מעבדת את הסרטון.
processingDetails.processingProgress.timeLeftMs	unsigned long אומדן של משך הזמן, במילי-שניות, שיידרש ל-YouTube כדי לסיים את העיבוד של הסרטון.
processingDetails.processingFailureReason	string הסיבה לכך שהמערכת של YouTube לא הצליחה לעבד את הסרטון. למאפיין הזה יהיה ערך רק אם הערך של המאפיין processingStatus הוא failed. הערכים החוקיים לנכס הזה הם: other – רכיב עיבוד אחר נכשל. streamingFailed – לא ניתן היה לשלוח את הסרטון לסטרימרים. transcodeFailed – המרת הקידוד של התוכן נכשלה. uploadFailed – שליחת הקובץ נכשלה.
processingDetails.fileDetailsAvailability	string הערך הזה מציין אם פרטי הקובץ זמינים עבור הסרטון שהועלו. כדי לאחזר את פרטי הקובץ של סרטון, יש לבקש את החלק fileDetails בבקשת videos.list().
processingDetails.processingIssuesAvailability	string הערך הזה מציין אם מנוע עיבוד הסרטונים יצר הצעות שעשויות לשפר את היכולת של YouTube לעבד את הסרטון, אזהרות שמסבירות בעיות בעיבוד הסרטון או שגיאות שגורמות לבעיות בעיבוד הסרטון. כדי לאחזר את ההצעות האלה, צריך לבקש את החלק suggestions בבקשה videos.list().
processingDetails.tagSuggestionsAvailability	string הערך הזה מציין אם יש הצעות למילות מפתח (תגים) עבור הסרטון. אפשר להוסיף תגים למטא-נתונים של סרטון כדי למשתמשים אחרים יהיה קל יותר למצוא אותו. כדי לאחזר את ההצעות האלה, צריך לבקש את החלק suggestions בבקשה videos.list().
processingDetails.editorSuggestionsAvailability	string הערך הזה מציין אם יש הצעות לעריכת הסרטון שעשויות לשפר את איכות הסרטון או את חוויית ההפעלה. כדי לאחזר את ההצעות האלה, אפשר לבקש את החלק suggestions בבקשת videos.list().
processingDetails.thumbnailsAvailability	string הערך הזה מציין אם נוצרו תמונות ממוזערות לסרטון.
suggestions	object האובייקט suggestions כולל הצעות לזיהוי הזדמנויות לשיפור איכות הסרטון או המטא-נתונים של הסרטון שהועלה. רק הבעלים של הסרטון יכולים לאחזר את הנתונים האלה. האובייקט suggestions יוחזר רק אם הערך של המאפיין processingDetails.tagSuggestionsAvailability או המאפיין processingDetails.editorSuggestionsAvailability הוא available.
suggestions.processingErrors[]	list רשימה של שגיאות שמונעות מ-YouTube לעבד את הסרטון שהועלו. השגיאות האלה מציינות שלמרות סטטוס העיבוד הנוכחי של הסרטון, סביר להניח שבסופו של דבר הסטטוס יהיה failed. הערכים התקינים של המאפיין הזה הם: archiveFile – קובץ ארכיון (למשל, קובץ ZIP). audioFile – הקובץ מכיל אודיו בלבד (למשל, קובץ MP3). docFile – מסמך או קובץ טקסט (למשל, מסמך MS Word). imageFile – קובץ תמונה (למשל, תמונה בפורמט JPEG). notAVideoFile – קובץ אחר שאינו וידאו. projectFile – קובץ פרויקט של סרט (למשל, פרויקט של Microsoft Windows Movie Maker).
suggestions.processingWarnings[]	list רשימה של סיבות אפשריות לבעיות בהמרת הקידוד של הסרטון שהועלה ל-YouTube או לשגיאה בהמרת הקידוד. האזהרות האלה נוצרות לפני שמערכת YouTube מעבדת בפועל את קובץ הווידאו שהועלו. בנוסף, הם מזהים בעיות שלא בהכרח מצביעות על כך שעיבוד הווידאו ייכשל, אבל עדיין עלולות לגרום לבעיות כמו בעיות בסנכרון, פריטי מידע שנוצרו בתהליך הפיתוח (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 תיאור הסרטון המותאם לשוק המקומי.