כל הסרטונים שיועלו דרך נקודת הקצה
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 התאריך והשעה שבהם הסרטון פורסם. שימו לב שהשעה הזו עשויה להיות שונה מהשעה שבה הסרטון הועלה. לדוגמה, אם סרטון הועלה כפרטי ולאחר מכן הוגדר כגלוי לכולם, המאפיין הזה יציין את המועד שבו הסרטון הוגדר כגלוי לכולם. יש כמה מקרים מיוחדים:
|
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 ערכי המפתח החוקיים הם:
|
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 תווים. חשוב לשים לב לכללים הבאים לגבי אופן החישוב של מגבלת התווים:
|
snippet.categoryId |
string קטגוריית הסרטון ב-YouTube שמשויכת לסרטון. צריך להגדיר ערך למאפיין הזה אם קוראים ל-method videos.update ומעדכנים את החלק snippet במשאב video . |
snippet.liveBroadcastContent |
string מציין אם הסרטון הוא שידור חי שמשודר עכשיו או שישודר בקרוב. לחלופין, הערך הוא 'none' אם הסרטון הוא לא שידור חי פעיל או שידור חי שעומד להתקיים. הערכים התקפים לנכס הזה הם:
|
snippet.defaultLanguage |
string השפה של הטקסט במאפיינים snippet.title ו-snippet.description של המשאב video . |
snippet.localized |
object האובייקט snippet.localized מכיל שם ותיאור מותאמים לסרטון או את השם בשפת ברירת המחדל של המטא-נתונים של הסרטון.
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 ) או רק באיכות רגילה.הערכים התקפים של המאפיין הזה הם:
|
contentDetails.caption |
string מציין אם יש כתוביות לסרטון. הערכים החוקיים לנכס הזה הם:
|
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 משמשים לסיווג תוכניות טלוויזיה לילדים. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.agcomRating |
string דירוג הסרטון מ-Autorità לפי le Garanzie nelle Comunicazioni (AGCOM). הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.anatelRating |
string דירוג Anatel (Asociación Nacional de Televisión) של הסרטון בטלוויזיה בצ'ילה. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.bbfcRating |
string הסיווג של הסרטון על ידי המועצה הבריטית לסיווג סרטים (BBFC). הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.bfvcRating |
string דירוג הסרטון על ידי מועצת צנזור הווידאו והקול בתאילנד. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.bmukkRating |
string הדירוג של הסרטון על ידי ועדת הסיווג של המדיה באוסטריה (Bundesministerium für Unterricht, Kunst und Kultur). הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.catvRating |
string מערכת סיווג לטלוויזיה בקנדה – מערכת סיווג הטלוויזיה בקנדה. דירוג הסרטון של ועדת הרדיו, הטלוויזיה והטלקומוניקציות בקנדה (CRTC) לשידורים בקנדה בשפה האנגלית. מידע נוסף זמין באתר של Canadian Broadcast Standards Council. הערכים התקינים של המאפיין הזה הם:
|
contentDetails.contentRating.catvfrRating |
string הסיווג של הסרטון מטעם Canadian Radio-Television and Telecommunications Commission (CRTC) לשידורים בקנדה בשפה הצרפתית. מידע נוסף זמין באתר של Canadian Broadcast Standards Council. הערכים התקינים של המאפיין הזה הם:
|
contentDetails.contentRating.cbfcRating |
string הדירוג של המועצה המרכזית לאישור סרטים (Central Board of Film Certification) (CBFC – הודו) של הסרטון. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.cccRating |
string דירוג Consejo de Calificación Cinematográfica (צ'ילה) של הסרטון. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.cceRating |
string הדירוג של הסרטון של הוועדה לסווג סרטים (Comissão de Classificação de Espect´culos) בפורטוגל. הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.chfilmRating |
string הדירוג של הסרטון בשווייץ. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.chvrsRating |
string הדירוג של הסרטון במערכת הסיווג של סרטונים ביתיים בקנדה (CHVRS). הערכים התקינים למאפיין הזה הם:
|
contentDetails.contentRating.cicfRating |
string דירוג הסרטון מאת Commission de Contrôle des Films (בלגיה). הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.cnaRating |
string דירוג הסרטון מ-CONSILIUL NATIONAL AL AUDIOVIZUALULUI ברומניה. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.cncRating |
string מערכת הסיווג בצרפת – נציבות הסיווג של הקולנוע ב-Cinetographique הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.csaRating |
string הדירוג של הסרטון על ידי Conseil supérieur de l'audiovisuel (המועצה העליונה לטלוויזיה ולרדיו) בצרפת, שמדרגת תוכן שידור. הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.cscfRating |
string דירוג הסרטון על ידי Commission de surveillance de la category des Films (CSCF) של לוקסמבורג. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.czfilmRating |
string הדירוג של הסרטון בצ'כיה. הערכים התקינים למאפיין הזה הם:
|
contentDetails.contentRating.djctqRating |
string הדירוג של הסרטון לפי Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT – ברזיל). הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.djctqRatingReasons[] |
list הסיבות לכך שהסרטון קיבל את הדירוג שלו ב-DJCQT (ברזיל). |
contentDetails.contentRating.ecbmctRating |
string מערכת דירוג בטורקיה – מועצת ההערכה והסיווג של משרד התרבות והתיירות הערכים התקינים של המאפיין הזה הם:
|
contentDetails.contentRating.eefilmRating |
string הדירוג של הסרטון באסטוניה. הערכים התקינים למאפיין הזה הם:
|
contentDetails.contentRating.egfilmRating |
string הדירוג של הסרטון במצרים. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.eirinRating |
string הדירוג של הסרטון לפי Eirin (映倫). Eirin הוא מערכת הסיווג ביפן. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.fcbmRating |
string הדירוג של הסרטון על ידי מועצת הצנזורה של מלזיה. הערכים התקינים לנכס הזה הם:
|
contentDetails.contentRating.fcoRating |
string הסיווג של הסרטון על ידי המשרד לניהול סרטים, עיתונים ומאמרים בהונג קונג. הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.fmocRating |
string הנכס הזה יצא משימוש ב-2 בנובמבר 2015. במקום זאת, יש להשתמש במאפיין contentDetails.contentRating.cncRating .דירוג הסרטון של Centre national du cinéma et de l'image animé (משרד התרבות הצרפתי). הערכים החוקיים של המאפיין הזה הם:
|
contentDetails.contentRating.fpbRating |
string הסיווג של הסרטון על ידי Film and Publication Board (הרשות לקולנוע ולפרסום) בדרום אפריקה. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.fpbRatingReasons[] |
list סיבות שמסבירות למה הסרטון קיבל את הדירוג שלו ב-FPB (דרום אפריקה). |
contentDetails.contentRating.fskRating |
string הסיווג של הסרטון לפי Freiwillige Selbstkontrolle der Filmwirtschaft (FSK – גרמניה). הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.grfilmRating |
string דירוג הסרטון ביוון. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.icaaRating |
string הדירוג של הסרטון לפי Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA – ספרד). הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.ifcoRating |
string הסיווג של הסרטון על ידי Irish Film Classification Office (IFCO – אירלנד). מידע נוסף זמין באתר IFCO. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.ilfilmRating |
string הדירוג של הסרטון בישראל. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.incaaRating |
string הדירוג INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) של הסרטון. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.kfcbRating |
string הדירוג של הסרטון על ידי ועדת הסיווג של סרטים בקניה. הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (הולנד). הערכים התקפים לנכס הזה הם:
|
contentDetails.contentRating.kmrbRating |
string הדירוג של הסרטון על ידי Korea Media Rating Board (영상물등급위원회). ה-KMRB מסווג סרטונים בדרום קוריאה. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.lsfRating |
string דירוג הסרטון מחיישן Lembaga באינדונזיה. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.mccaaRating |
string דירוג הסרטון מוועדת סיווג הגיל של הסרטים במלטה. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.mccypRating |
string הסיווג של הסרטון על ידי מועצת המדיה של ילדים ובני נוער של מכון הקולנוע הדני (Det Danske Filminstitut). הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.mcstRating |
string מערכת הסיווג של הסרטון בווייטנאם – MCST הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.mdaRating |
string הדירוג של הסרטון מטעם רשות הפיתוח של המדיה (MDA) בסינגפור, ובפרט מטעם מועצת הצנזורה של הסרטים (BFC). הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.medietilsynetRating |
string הסיווג של הסרטון על ידי Medietilsynet, הרשות הנורווגית לענייני מדיה. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.mekuRating |
string דירוג הסרטון מטעם Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute) בפינלנד). הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.mibacRating |
string הדירוג של הסרטון לפי Ministero dei Beni e delle Attività Culturali e del Turismo (איטליה). הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.mocRating |
string הדירוג של הסרטון על ידי Ministerio de Cultura (קולומביה). הערכים התקינים למאפיין הזה הם:
|
contentDetails.contentRating.moctwRating |
string הדירוג של הסרטון לפי משרד התרבות של טייוואן (文化部). הערכים התקינים למאפיין הזה הם:
|
contentDetails.contentRating.mpaaRating |
string הסיווג של הסרטון לפי Motion Picture Association of America (MPAA). הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.mpaatRating |
string הסיווג של Motion Picture Association of America (איגוד הסרטים של אמריקה) לטריילרים ולקטעים מקדימים של סרטים. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.mtrcbRating |
string דירוג הסרטון מוועדת הביקורת והסיווג של סרטים וטלוויזיה (הפיליפינים). הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.nbcRating |
string דירוג הסרטון של המשרד הלאומי לסיווג בסרי לנקה. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.nfrcRating |
string הדירוג של הסרטון מ-Bulgarian National Film Center. הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.nfvcbRating |
string הדירוג של הסרטון על ידי המועצה הלאומית של ניגריה לבקרת סרטים ווידאו. הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.nkclvRating |
string הסיווג של הסרטון לפי Nacionãlais Kino centrs (המרכז הלאומי לקולנוע בלטביה). הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.oflcRating |
string הדירוג של המשרד לסיווג סרטים וספרות של הסרטון (OFLC – ניו זילנד). הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.pefilmRating |
string דירוג הסרטון בפרו. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.resorteviolenciaRating |
string דירוג הסרטון בוונצואלה. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.rtcRating |
string הדירוג של הסרטון לפי המנהל הכללי של רדיו, טלוויזיה וקולנוע (מקסיקו). הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.rteRating |
string דירוג הסרטון מטעם Raidió Teilifís Éireann שבאירלנד. הערכים החוקיים לנכס הזה הם:
|
contentDetails.contentRating.russiaRating |
string הדירוג של הסרטון במרשם הסרטים הלאומי של הפדרציה הרוסית (MKRF – רוסיה). הערכים התקינים למאפיין הזה הם:
|
contentDetails.contentRating.skfilmRating |
string הדירוג של הסרטון בסלובקיה. הערכים התקינים למאפיין הזה הם:
|
contentDetails.contentRating.smaisRating |
string הדירוג של הסרטון באיסלנד. הערכים התקינים למאפיין הזה הם:
|
contentDetails.contentRating.smsaRating |
string הדירוג של הסרטון מ-Statens medieråd (מועצת המדיה הלאומית של שוודיה). הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.tvpgRating |
string הסיווג של הסרטון בהתאם להנחיות ה-TVPG (הנחיות להורים בנוגע לתוכניות טלוויזיה). הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.ytRating |
string סיווג שמשמש את YouTube לזיהוי תוכן עם הגבלת גיל. הערכים התקפים למאפיין הזה הם:
|
contentDetails.projection |
string מציין את פורמט הקרנה של הסרטון. הערכים התקינים למאפיין הזה הם:
|
contentDetails.hasCustomThumbnail |
boolean מציין אם מעלה הסרטון סיפק תמונה ממוזערת מותאמת אישית לסרטון. הנכס הזה גלוי רק למעלה הסרטון. |
status |
object האובייקט status מכיל מידע על סטטוס ההעלאה, העיבוד והפרטיות של הסרטון. |
status.uploadStatus |
string הסטטוס של הסרטון שהועלו. הערכים התקינים למאפיין הזה הם:
|
status.failureReason |
string הערך הזה מסביר למה ההעלאה של הסרטון נכשלה. המאפיין הזה מופיע רק אם המאפיין uploadStatus מציין שההעלאה נכשלה.הערכים החוקיים למאפיין הזה הם:
|
status.rejectionReason |
string הערך הזה מסביר למה YouTube דחה סרטון שהעליתם. המאפיין הזה מופיע רק אם המאפיין uploadStatus מציין שההעלאה נדחתה.הערכים החוקיים למאפיין הזה הם:
|
status.privacyStatus |
string סטטוס הפרטיות של הסרטון. הערכים החוקיים לנכס הזה הם:
|
status.publishAt |
datetime התאריך והשעה שבהם הסרטון מתוזמן לפרסום. אפשר להגדיר אותו רק אם סטטוס הפרטיות של הסרטון הוא 'פרטי'. הערך מצוין בפורמט ISO 8601. חשוב לשים לב לשני הדברים הבאים לגבי ההתנהגות של המאפיין הזה:
|
status.license |
string הרישיון של הסרטון. הערכים התקינים למאפיין הזה הם:
|
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> שמטמיע נגן שמפעיל את הסרטון. |
player.embedHeight |
long הגובה של הנגן המוטמע שמוחזר במאפיין player.embedHtml . המאפיין הזה מוחזר רק אם בבקשה צוין ערך לפרמטרים maxHeight או maxWidth ויחס הגובה-רוחב של הסרטון ידוע. |
player.embedWidth |
long הרוחב של הנגן המוטמע שמוחזר בנכס player.embedHtml . המערכת מחזירה את המאפיין הזה רק אם בבקשה צוין ערך לפרמטר maxHeight ו/או לפרמטר maxWidth , ויחס הגובה-רוחב של הסרטון ידוע. |
topicDetails |
object האובייקט topicDetails מכיל מידע על הנושאים שמשויכים לסרטון.חשוב: פרטים נוספים על השינויים הצפויים שקשורים למזהי נושאים מופיעים בהגדרות של המאפיינים topicDetails.relevantTopicIds[] ו-topicDetails.topicIds[] , וגם בהיסטוריית הגרסאות. |
topicDetails.topicIds[] |
list חשוב: המאפיין הזה הוצא משימוש החל מ-10 בנובמבר 2016. ה-API לא מחזיר יותר ערכים לנכס הזה, וכל הנושאים שמשויכים לסרטון מוחזרים עכשיו באמצעות ערך הנכס topicDetails.relevantTopicIds[] . |
topicDetails.relevantTopicIds[] |
list רשימה של מזהי נושאים שרלוונטיים לסרטון. הנכס הזה הוצא משימוש החל מ-10 בנובמבר 2016. התמיכה בה תהיה זמינה עד 10 בנובמבר 2017. חשוב: עקב ההוצאה משימוש של Freebase ו-Freebase API, החל מ-27 בפברואר 2017 מזהי נושאים התחילו לפעול בצורה שונה. באותו זמן, YouTube התחיל להחזיר קבוצה קטנה של מזהים של נושאים שנבחרו בקפידה. |
topicDetails.topicCategories[] |
list רשימת כתובות URL בוויקיפדיה שמספקות תיאור ברמה גבוהה של תוכן הסרטון. |
recordingDetails |
object האובייקט recordingDetails מכיל מידע על המיקום, התאריך והכתובת שבהם צולם הסרטון. |
recordingDetails.locationDescription |
string המאפיין הזה הוצא משימוש ב-1 ביוני 2017. לפרטים נוספים אפשר לעיין בהודעה על הוצאה משימוש. טקסט התיאור של המיקום שבו צולם הסרטון. |
recordingDetails.location |
object נתוני המיקום הגיאוגרפי שמשויך לסרטון. שימו לב שערכים של נכסי הצאצאים מזהים את המיקום שבעלי הסרטון רוצים לשייך לסרטון. אפשר לערוך את הערך, לחפש אותו בסרטונים גלויים לכולם, ויכול להיות שהוא יוצג למשתמשים בסרטונים גלויים לכולם. |
recordingDetails.location.latitude |
double המאפיין הזה הוצא משימוש ב-1 ביוני 2017. פרטים נוספים זמינים בהודעה על ההוצאה משימוש. קו הרוחב במעלות. |
recordingDetails.location.longitude |
double הנכס הזה יצא משימוש ב-1 ביוני 2017. לפרטים נוספים אפשר לעיין בהודעה על הוצאה משימוש. קו האורך במעלות. |
recordingDetails.location.altitude |
double הנכס הזה יצא משימוש ב-9 ביולי 2018. פרטים נוספים זמינים בהודעה על ההוצאה משימוש. הגובה מעל אליפסואיד העזר, במטרים. |
recordingDetails.recordingDate |
datetime התאריך והשעה שבהם הסרטון צולם. הערך מצוין בפורמט ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ). |
fileDetails |
object האובייקט fileDetails מכיל מידע על קובץ הווידאו שהועלה ל-YouTube, כולל הרזולוציה, משך הזמן, קודיקים של אודיו ווידאו, קצב העברת הנתונים של הסטרימינג ועוד. רק הבעלים של הסרטון יכולים לאחזר את הנתונים האלה.האובייקט fileDetails יוחזר רק אם הערך של המאפיין processingDetails.fileAvailability הוא available . |
fileDetails.fileName |
string שם הקובץ שהועלה. השדה הזה מופיע גם אם העליתם קובץ וידאו וגם אם העליתם קובץ מסוג אחר. |
fileDetails.fileSize |
unsigned long גודל הקובץ שהועלה, בבייטים. השדה הזה מופיע גם אם העליתם קובץ וידאו וגם אם העליתם קובץ מסוג אחר. |
fileDetails.fileType |
string סוג הקובץ שהועלה, כפי שזוהה על ידי מנוע עיבוד הווידאו של YouTube. בשלב זה, מערכת YouTube מעבדת רק קובצי וידאו, אבל השדה הזה מופיע גם אם העליתם קובץ וידאו וגם אם העליתם קובץ מסוג אחר. הערכים התקינים של המאפיין הזה הם:
|
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 צריך לבצע בתוכן המקור המקורי כדי להציג את הסרטון בצורה תקינה. הערכים התקינים של המאפיין הזה הם:
|
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:
|
processingDetails |
object האובייקט processingDetails כולל מידע על ההתקדמות של YouTube בעיבוד קובץ הסרטון שהועלה. המאפיינים באובייקט מזהים את סטטוס העיבוד הנוכחי ואת ההערכה לזמן שנותר עד ש-YouTube יסיים לעבד את הסרטון. החלק הזה מציין גם אם סוגים שונים של נתונים או תוכן זמינים לסרטון, כמו פרטי קובץ או תמונות ממוזערות.האובייקט processingProgress מיועד לסקרים, כדי שאפשר יהיה לעקוב אחרי ההתקדמות של YouTube בעיבוד קובץ הווידאו שהועלה. רק הבעלים של הסרטון יכולים לאחזר את הנתונים האלה. |
processingDetails.processingStatus |
string סטטוס העיבוד של הסרטון. הערך הזה מציין אם מערכת YouTube הצליחה לעבד את הסרטון, או אם הסרטון עדיין בתהליך עיבוד. הערכים החוקיים לנכס הזה הם:
|
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 .הערכים החוקיים לנכס הזה הם:
|
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 .הערכים התקינים של המאפיין הזה הם:
|
suggestions.processingWarnings[] |
list רשימה של סיבות אפשריות לבעיות בהמרת הקידוד של הסרטון שהועלה ל-YouTube או לשגיאה בהמרת הקידוד. האזהרות האלה נוצרות לפני שמערכת YouTube מעבדת בפועל את קובץ הווידאו שהועלו. בנוסף, הם מזהים בעיות שלא בהכרח מצביעות על כך שעיבוד הווידאו ייכשל, אבל עדיין עלולות לגרום לבעיות כמו בעיות בסנכרון, פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) או טראק של אודיו חסר. הערכים החוקיים של הנכס הזה הם:
|
suggestions.processingHints[] |
list רשימת הצעות שעשויות לשפר את היכולת של YouTube לעבד את הסרטון. הערכים התקפים למאפיין הזה הם:
|
suggestions.tagSuggestions[] |
list רשימה של תגים של מילות מפתח שאפשר להוסיף למטא-נתונים של הסרטון כדי להגדיל את הסיכוי שהמשתמשים יאתרו את הסרטון כשהם מחפשים או גולשים ב-YouTube. |
suggestions.tagSuggestions[].tag |
string תג מילת המפתח שהמערכת הציעה לסרטון. |
suggestions.tagSuggestions[].categoryRestricts[] |
list קבוצה של קטגוריות של סרטונים שהתג רלוונטי להן. ניתן להשתמש במידע הזה כדי להציג הצעות לתגים מתאימות על סמך קטגוריית הסרטון שמעלה הסרטון משייך אליו. כברירת מחדל, ההצעות לתוויות רלוונטיות לכל הקטגוריות אם לא מוגדרות הגבלות למילות המפתח. |
suggestions.editorSuggestions[] |
list רשימה של פעולות של עריכת סרטונים שעשויות לשפר את איכות הווידאו או את חוויית ההפעלה של הסרטון שהועלה. הערכים החוקיים לנכס הזה הם:
|
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 תיאור הסרטון המותאם לשוק המקומי. |