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
},
"brandPartner": {
"channelId": string,
"channelHandle": 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 התקפים, למעט < ו->. כדי ליצור פרקים בסרטון, צריך להוסיף לתיאור חותמות זמן מעוצבות (לדוגמה, 00:00). |
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 משמשים לסיווג תוכניות טלוויזיה לילדים. הערכים התקינים של המאפיין הזה הם:
|
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סיווג הסרטון על ידי המועצה האוסטרית לסיווג מדיה (Bundesministerium für Unterricht, Kunst und Kultur). הערכים התקפים של המאפיין הזה הם:
|
contentDetails.contentRating.catvRating |
stringמערכת הסיווג לתוכניות טלוויזיה בקנדה – Canadian TV Classification System (מערכת הסיווג לתוכניות טלוויזיה בקנדה) הסיווג של הסרטון מטעם 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 הערכים התקפים של המאפיין הזה הם:
|
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הסיווג של הסרטון מ-Media Council for Children and Young People (מועצת המדיה לילדים ולצעירים) של Danish Film Institute (מכון הסרטים הדני, 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הסיווג של הסרטון ממועצת הצנזורה הלאומית של ניגריה לסרטים ולסרטוני וידאו. הערכים התקפים של המאפיין הזה הם:
|
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הדירוג של הסרטון מטעם General Directorate of Radio, Television and Cinematography (מקסיקו). הערכים התקפים של המאפיין הזה הם:
|
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מספר הפעמים שבהן צפו בסרטון. החל מ-24 באוגוסט 2026, בכל הפורמטים של סרטונים (סרטונים ארוכים, שידורים חיים וסרטוני 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המזהה של הצ'אט הפעיל בשידור חי שמצורף לסרטון הזה. השדה הזה מתמלא רק אם הסרטון הוא שידור חי שמוצג כרגע ויש בו צ'אט בשידור חי. אחרי שהשידור יסתיים, השדה הזה יוסר והצ'אט בשידור חי ייסגר. בשידורים מתמשכים, מזהה הצ'אט בשידור חי לא יהיה יותר מקושר לסרטון הזה, אלא לסרטון החדש שמוצג בדף המתמשך. |
brandPartner |
objectאובייקט brandPartner מכיל פרטים על שותף המותג שמקושר לסרטון לצורך גישה לשותפי מותג ביוזמת היוצרים (CI BPA). |
brandPartner.channelId |
stringמזהה הערוץ החיצוני של השותף של המותג. השדה הזה חייב להתחיל ב-UC. כשמגדירים גישה, צריך להגדיר את channelId או את channelHandle, אבל רק channelId מוחזר בתגובה. |
brandPartner.channelHandle |
stringהכינוי של שותף המותג בערוץ. השדה הזה חייב להתחיל ב-'@'. כשמגדירים גישה, צריך להגדיר את channelId או את channelHandle, אבל רק channelId מוחזר בתגובה. |
localizations |
objectהאובייקט localizations מכיל תרגומים של המטא-נתונים של הסרטון. |
localizations.(key) |
objectהשפה של הטקסט המותאם לשוק המקומי שמשויך לערך המפתח. הערך הוא מחרוזת שמכילה קוד שפה בתקן BCP-47. |
localizations.(key).title |
stringשם הסרטון שמותאם לשוק המקומי. |
localizations.(key).description |
stringתיאור הסרטון שמותאם לשוק המקומי. |