כל הסרטונים שהועלו דרך נקודת הקצה
videos.insert מפרויקטים של ממשקי API לא מאומתים שנוצרו אחרי 28 ביולי 2020 יוגבלו למצב צפייה פרטי. כדי לבטל את ההגבלה הזו, כל פרויקט API צריך לעבור ביקורת כדי לוודא שהוא עומד בתנאי השירות. פרטים נוספים זמינים בהיסטוריית הגרסאות של ה-API.
משאב video מייצג סרטון ב-YouTube.
Methods
ה-API תומך בשיטות הבאות למשאבי videos:
- getRating
- אחזור הדירוגים שהמשתמש המורשה נתן לרשימת סרטונים ספציפית. כדאי לנסות עכשיו.
- list
- מחזירה רשימה של סרטונים שתואמים לפרמטר הבקשה של ה-API. כדאי לנסות עכשיו.
- insert
- העלאת סרטון ל-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 שמשויכת לסרטון. צריך להגדיר ערך למאפיין הזה אם קוראים לשיטה 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 ( 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הסיווג של הסרטון על ידי Australian Classification Board (ACB) או Australian Communications and Media Authority (ACMA). דירוגים של ACMA משמשים לסיווג תוכניות טלוויזיה לילדים. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.agcomRating |
stringהדירוג של הסרטון מ-Autorità per 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הסיווג של הסרטון מטעם ועדת הרדיו, הטלוויזיה והטלקומוניקציות הקנדית (CRTC) לשידורים בקנדה בשפה הצרפתית. מידע נוסף זמין באתר של Canadian Broadcast Standards Council. הערכים התקינים של המאפיין הזה הם:
|
contentDetails.contentRating.cbfcRating |
stringהדירוג של הסרטון על ידי המועצה המרכזית לבדיקת סרטים (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 (CNA) ברומניה. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.cncRating |
stringמערכת סיווג בצרפת – Commission de classification cinematographique הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.csaRating |
stringהדירוג של הסרטון על ידי Conseil supérieur de l'audiovisuel (המועצה העליונה לטלוויזיה ולרדיו) בצרפת, שמדרגת תוכן שידור. הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.cscfRating |
stringהסיווג של הסרטון על ידי Commission de surveillance de la classification 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 – ארגנטינה). הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.kfcbRating |
stringהדירוג של הסרטון לפי ועדת הסיווג של סרטים בקניה. הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.kijkwijzerRating |
stringvoor de Classificatie van Audiovisuele Media (הולנד). הערכים התקפים לנכס הזה הם:
|
contentDetails.contentRating.kmrbRating |
stringהדירוג של הסרטון על ידי Korea Media Rating Board (영상물등급위원회). ה-KMRB מסווג סרטונים בדרום קוריאה. הערכים החוקיים למאפיין הזה הם:
|
contentDetails.contentRating.lsfRating |
stringהדירוג של הסרטון מ-Lembaga Sensor Film באינדונזיה. הערכים התקפים לנכס הזה הם:
|
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 (המכון הלאומי לאמנויות הווידאו) בפינלנד. הערכים התקפים למאפיין הזה הם:
|
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הדירוג של הסרטון לפי Movie and Television Review and Classification Board (Philippines). הערכים התקפים למאפיין הזה הם:
|
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הסיווג של הסרטון לפי Office of Film and Literature Classification (OFLC – ניו זילנד). הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.pefilmRating |
stringהדירוג של הסרטון בפרו. הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.resorteviolenciaRating |
stringהדירוג של הסרטון בוונצואלה. הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.rtcRating |
stringהסיווג של הסרטון על ידי המנהל הכללי של רדיו, טלוויזיה וצילום (מקסיקו). הערכים התקפים למאפיין הזה הם:
|
contentDetails.contentRating.rteRating |
stringדירוג הסרטון של Raidió Teilifís Éireann (RTÉ) באירלנד. הערכים החוקיים למאפיין הזה הם:
|
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 בנושא תוכן של שירותי תמיכהדוגמאות לתוכן של שירותי בריאות כוללות סרטונים שבהם:
|
statistics |
objectהאובייקט statistics מכיל נתונים סטטיסטיים על הסרטון. |
statistics.viewCount |
unsigned longמספר הפעמים שבהן צפו בסרטון. החל מ-31 במרץ 2025, עבור סרטוני Shorts, הפונקציה viewCount תחזיר את מספר הפעמים שסרטון Shorts התחיל לפעול או הופעל מחדש, ללא דרישה לזמן צפייה מינימלי. |
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 מעבדת בפועל את קובץ הווידאו שהועלו. בנוסף, הם מזהים בעיות שלא בהכרח גורמות לכישלון בעיבוד הווידאו, אבל עדיין עלולות לגרום לבעיות כמו בעיות בסנכרון, פגמים בווידאו או טראק אודיו חסר. הערכים התקינים של המאפיין הזה הם:
|
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תיאור הסרטון המותאם לשוק המקומי. |