כל הסרטונים שהועלו דרך נקודת הקצה
videos.insert
מפרויקטים לא מאומתים של API שנוצרו אחרי 28 ביולי 2020 יהיו מוגבלים למצב צפייה פרטי. כדי להסיר את ההגבלה הזו, כל פרויקט API צריך לעבור ביקורת כדי לוודא שהוא עומד בדרישות התנאים וההגבלות. מידע נוסף זמין בהיסטוריית הגרסאות של ה-API.
משאב video מייצג סרטון ב-YouTube.
Methods
ה-API תומך בשיטות הבאות למשאבי videos:
- getRating
- אחזור הדירוגים שהמשתמש המורשה נתן לרשימה של סרטונים ספציפיים. כדאי לנסות עכשיו.
- list
- מחזירה רשימה של סרטונים שתואמים לפרמטרים של בקשת ה-API. כדאי לנסות עכשיו.
- batchGetStats
- מאחזר רשימה של נתונים סטטיסטיים של סרטונים שתואמים לפרמטרים של בקשת ה-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 שמשויכת לסרטון. צריך להגדיר ערך למאפיין הזה אם קוראים לשיטת videos.update ומעדכנים את החלק snippet במשאב video. |
snippet.liveBroadcastContent |
stringמציין אם הסרטון הוא שידור חי פעיל או שידור חי שצפוי להתחיל. הערך שלו הוא הערכים התקינים של המאפיין הזה הם:
|
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 משמשים לסיווג של תוכניות טלוויזיה לילדים. stringהערכים התקינים של המאפיין הזה הם:
|
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הסיווג של הסרטון על ידי British Board of Film Classification (BBFC). הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.bfvcRating |
stringהדירוג של הסרטון ממועצת הצנזורה של סרטים וסרטוני וידאו בתאילנד. הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.bmukkRating |
stringסיווג הסרטון על ידי Austrian Board of Media Classification (המועצה האוסטרית לסיווג מדיה, Bundesministerium für Unterricht, Kunst und Kultur). הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.catvRating |
stringמערכת הסיווג לתוכניות טלוויזיה בקנדה – מערכת הסיווג לתוכניות טלוויזיה בקנדה. הסיווג של הסרטון מטעם Canadian Radio-Television and Telecommunications Commission (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 (CNA) ברומניה. הערכים התקינים של המאפיין הזה הם:
|
contentDetails.contentRating.cncRating |
stringמערכת הסיווג בצרפת – Commission de classification cinematographique stringהערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.csaRating |
stringהסיווג של הסרטון מ-Conseil supérieur de l'audiovisuel בצרפת, שקובע סיווג לתוכן לשידור. הערכים התקינים של המאפיין הזה הם:
|
contentDetails.contentRating.cscfRating |
stringהסיווג של הסרטון מטעם הוועדה לפיקוח על סיווג סרטים (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מערכת הסיווג בטורקיה – Evaluation and Classification Board of the Ministry of Culture and Tourism הערכים התקפים של המאפיין הזה הם:
|
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דירוג הסרטון מטעם מועצת הסרטים והפרסומים של דרום אפריקה. הערכים התקפים של המאפיין הזה הם:
|
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הדירוג של הסרטון מ-Kenya Film Classification Board (המועצה לסיווג סרטים בקניה). הערכים התקפים של המאפיין הזה הם:
|
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הסיווג של הסרטון מטעם Media Development Authority (רשות פיתוח המדיה) של סינגפור, ובאופן ספציפי, מטעם Board of Film Censors (המועצה לסיווג סרטים, 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הסיווג של איגוד MPAA לטריילרים ולתצוגות מקדימות של סרטים. הערכים התקינים של המאפיין הזה הם:
|
contentDetails.contentRating.mtrcbRating |
stringהסיווג של הסרטון מ-Movie and Television Review and Classification Board (הפיליפינים). הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.nbcRating |
stringהסיווג של הסרטון מטעם Maldives National Bureau of Classification (הלשכה הלאומית לסיווג של המלדיבים). הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.nfrcRating |
stringהסיווג של הסרטון מהמרכז הלאומי לקולנוע בבולגריה. הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.nfvcbRating |
stringהסיווג של הסרטון מ-Nigeria's National Film and Video Censors Board (המועצה הלאומית לסינון סרטים וסרטונים בניגריה). הערכים התקפים של המאפיין הזה הם:
|
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 באירלנד. הערכים התקינים של המאפיין הזה הם:
|
contentDetails.contentRating.russiaRating |
stringסיווג התוכן של הסרטון מטעם National Film Registry of the Russian Federation (MKRF – רוסיה). הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.skfilmRating |
stringסיווג הסרטון בסלובקיה. הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.smaisRating |
stringהסיווג של הסרטון באיסלנד. הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.smsaRating |
stringסיווג הסרטון מ-Statens medieråd (המועצה הלאומית לתקשורת של שוודיה). הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.tvpgRating |
stringסיווג התוכן של הסרטון לפי TV Parental Guidelines (הנחיות להורים בנוגע לתוכניות טלוויזיה, 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, הפונקציה 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התג keyword שהוצע לסרטון. |
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תיאור הסרטון שמותאם לשוק המקומי. |