ממשק API לסטרימינג בשידור חי של YouTube – היסטוריית גרסאות

בדף הזה מפורטים השינויים ב-YouTube Live Streaming API ועדכונים במסמכים. הרשמה ליומן השינויים הזה. הרשמה

‫18 באוגוסט 2026

העדכון הזה כולל את השינויים הבאים:

  • התיעוד של השיטה liveBroadcasts.update עודכן ונוספו לו שגיאות חדשות שקשורות למונטיזציה: preconditionFailed (412) (סיבה: videoNotEligibleForAdsMonetization) ו-backendError (503) (סיבה: backendError).

‫17 באוגוסט 2026

העדכון הזה כולל את השינויים הבאים:

  • המאפיין החדש snippet.categoryId של משאב liveBroadcast מאפשר לך להגדיר, לעדכן ולאחזר את קטגוריית הווידאו המשויכת לשידור חי.

‫20 ביולי 2026

העדכון הזה כולל את השינויים הבאים:

‫9 ביולי 2026

העדכון הזה כולל את השינויים הבאים:

‫1 ביוני 2026

העדכון הזה כולל את השינויים הבאים:

  • המאפיין contentDetails.availabilityConfig של המשאב liveBroadcast מאפשר לך לציין מגבלות גיאוגרפיות לשידור חי, כך שתוכל לנהל זמינות אזורית לאירועים חיים.

‫26 במרץ 2026

העדכון הזה כולל את השינויים הבאים:

  • במאפיין snippet.type יש עכשיו תמיכה בערך החדש giftEvent.

  • המאפיין החדש snippet.giftEventDetails של משאב liveChatMessage והצאצאים שלו מכילים מידע על אירוע המתנה.

‫12 בינואר 2026

ה-API תומך עכשיו בהפעלת מודעות באמצע הסרטון ובהוספה אוטומטית של מודעות באמצע הסרטון לשידורים חיים.

בעל השידור יכול לבחור להפעיל מודעות אמצע סרטונים עבור שידור כל עוד השידור זכאי למודעות אמצע סרטונים. הבעלים יכול גם לכבות מודעות אמצעיות לשידור בכל עת.

אם הפעלתם מודעות באמצע הסרטון בשידור, בעל השידור יכול להפעיל הוספה אוטומטית של מודעות באמצע הסרטון. הם יכולים גם להשבית את המודעות האוטומטיות לשידור בכל שלב.

כשבעלי השידור מפעילים מודעות אוטומטיות, הם יכולים לבחור באחת מהאפשרויות הבאות:

  • מערכת YouTube תבצע אופטימיזציה של הוספת מודעות באמצע הסרטון. האפשרות הזו תומכת בשלושה מצבים:
    • נמוך: פוטנציאל רווחים נמוך יותר, פחות הפרעות בחוויית הצופים
    • בינונית: פוטנציאל בינוני להכנסות, חוויית צפייה מאוזנת
    • גבוה: פוטנציאל רווחים גבוה יותר, חוויית צפייה מופרעת יותר
  • הגדר ידנית את האסטרטגיה והמרווח להכנסת מודעות באמצע הסרטון. במקרה כזה, הבעלים צריך להגדיר שני פרמטרים:
    1. אסטרטגיית התזמון של נקודות לציון מיקום של מודעות. ניתן להוסיף נקודות רמז בו זמנית עבור כל הצופים, או שתזמון נקודות הרמז יכול להשתנות מצופה לצופה. האסטרטגיה השנייה מאפשרת ל-YouTube לתזמן נקודות ציון בקצב גבוה יותר, כך שהצופים יוכלו לקבל נקודות ציון כשהם עומדים בדרישות.
    2. אורך המרווח בין הפסקות למודעות באמצע הסרטון.

התיעוד משקף את השינויים הבאים ב-API כדי לתמוך בתכונה זו:

  • אובייקט liveBroadcast resource monetizationDetails כולל שדות להפעלת מודעות באמצע הסרטון ולהגדרות של מודעות אוטומטיות.
  • אפשר להשתמש בשיטה update כדי להפעיל או להשבית מודעות באמצע הסרטון. ניתן להשתמש בשיטה זו גם כדי להגדיר את המודעות האוטומטיות לשידור חי. במסמכי התיעוד מפורטות כמה שגיאות חדשות שיכולות להתרחש כשמעדכנים את הגדרות המונטיזציה והמודעות האוטומטיות לשידור חי.

‫14 ביולי 2025

התיאור של השיטה liveChatMessages.streamList עודכן כדי לספק הנחיות לגבי השימושים ב-streamList API.

‫9 באוקטובר 2023

לעיון בלבד, ניתן למצוא אילו מזהי מדבקות קשורים לאילו Super Stickers בקובץ CSV הזה. ההגדרות של המאפיין snippet.superStickerDetails.superStickerMetadata.stickerId של משאב liveChatMessage ושל המאפיין snippet.superStickerMetadata.stickerId של משאב superChatEvent עודכנו שתיהן כדי לשקף מידע זה.

‫15 בספטמבר 2023

ה-API תומך עכשיו בדרך חדשה להוספת מודעות לשידורים חיים. בנוסף לliveCuepoints, שמאפשר לכם להוסיף הפסקות למודעות לשידור באופן ידני, מעכשיו YouTube תומך בתכונה להוספה אוטומטית של הפסקות למודעות באמצע הסרטון לשידור במרווחי זמן קבועים.

אם בעלי השידור מפעילים מודעות אוטומטיות, הם יכולים לראות את ההיבטים הבאים של התנהגות המודעות:

  • אורך המרווח בין הפסקות לפרסומות באמצע הסרטון.
  • אסטרטגיית התזמון של נקודות ציון להצגת מודעות. אפשר להוסיף את נקודות ה-Cue בו-זמנית לכל הצופים, או שהתזמון של נקודות ה-Cue יכול להיות שונה מצופה לצופה. האסטרטגיה השנייה מאפשרת ל-YouTube לתזמן נקודות ציון בקצב גבוה יותר, כך שהצופים יוכלו לקבל נקודות ציון כשהם עומדים בדרישות.
  • תקופה שבמהלכה לא מוצגות מודעות באמצע הסרטון. במסגרת התכונה הזו, בעל השידור מציין שמודעות באמצע הסרטון לא יוצגו עד שעה מסוימת.

התיעוד משקף את השינויים הבאים ב-API כדי לתמוך בתכונה זו:

  • המשאב liveBroadcast מכיל כעת אובייקט monetizationDetails. שדות האובייקט מציינים האם הוספת מודעות אוטומטית מופעלת עבור השידור ומציינים מידע נוסף לתזמון נקודות רמז.
  • הפרמטר part של השיטה liveBroadcast.list תומך בערך monetizationDetails.
  • ניתן להשתמש בשיטת update כדי להשהות הכנסת מודעות אמצע סרטון למשך פרק זמן מסוים עבור שידור חי. בנוסף, במסמכי התיעוד מפורטות עכשיו כמה שגיאות שיכולות להתרחש כשמעדכנים את פרטי המונטיזציה של שידור חי.

‫1 באוגוסט 2023

העדכון הזה כולל את השינויים הבאים:

  • בשיטה liveBroadcasts.update כבר לא צריך לציין ערכים בשדות הבאים:

    • snippet.title
    • status.privacyStatus

    אם לא תכללו את השדות האלה בבקשה, הם לא ישתנו.

1 בנובמבר 2022

  • השיטה החדשה liveBroadcasts.cuepoint מאפשרת לכל בעל ערוץ שמפעיל שידור חי ביוטיוב להכניס נקודות רמז (cuepoints) לשידור, מה שיכול להפעיל הפסקות פרסומות. השיטה הזו מחליפה את השיטה liveCuepoints.insert, שאיפשרה רק לשותפי תוכן ב-YouTube להוסיף נקודות ציון לשידורים חיים.

    עדכנו כמה מדריכים כדי לשקף את הזמינות של השיטה החדשה הזו.

  • הערה: זוהי הודעה על הוצאה משימוש.

    השיטה liveCuepoints.insert הוצאה משימוש. התמיכה בשיטה liveCuepoints.insert תוסר ב-1 במאי 2023 או אחרי התאריך הזה. משתמשי API צריכים לעדכן את היישומים שלהם כדי לקרוא לשיטת liveBroadcasts.cuepoint במקום זאת.

  • התיעוד של השיטה liveBroadcasts.control הוסר. A הודעה על הוצאה משימוש של השיטה הזו פורסמה בספטמבר 2020.

1 באוקטובר, 2022

העדכון הזה כולל את השינויים הבאים:

  • בשיטה liveBroadcasts.update כבר לא צריך לציין ערכים בשדות הבאים:

    • contentDetails.enableContentEncryption
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.startWithSlate

    אם לא תכללו את השדות האלה בבקשה, הם לא ישתנו.

  • הוסר התיעוד של שדות liveBroadcast שיצאו משימוש:

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

‫1 באפריל 2022

העדכון הזה כולל את השינויים הבאים:

  • במאפיין snippet.type יש עכשיו תמיכה בשני ערכים חדשים:

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

  • המאפיין החדש snippet.membershipGiftingDetails של משאב liveChatMessage והצאצאים שלו מכילים מידע על אירוע חברות במועדון במתנה. באופן דומה, הנכס החדש של snippet.giftMembershipReceivedDetails והצאצאים שלו מכילים מידע על אירוע קבלת חברות במתנה.

‫15 בספטמבר 2021

העדכון הזה כולל את השינויים הבאים:

  • במאפיין snippet.type יש עכשיו תמיכה בשני ערכים חדשים:

    • newSponsorEvent
    • memberMilestoneChatEvent

  • המאפיין החדש snippet.memberMilestoneChatDetails של משאב liveChatMessage והמאפיינים המשניים שלו מכילים מידע על אירוע הצ'אט של חברי מועדון שהגיעו לציון דרך. באופן דומה, המאפיין snippet.newSponsorDetails החדש והמאפיינים המשניים שלו מכילים מידע על אירוע הספונסר החדש.

1 בדצמבר 2020

השיטה liveBroadcasts.transition של ה-API תומכת בשגיאה חדשה 403 (Forbidden), שמציינת שהמשתמש שלח יותר מדי בקשות בפרק זמן נתון. סיבת השגיאה היא userRequestsExceedRateLimit.

21 בספטמבר 2020

  • ההגדרה של מאפיין liveBroadcast במשאב status.madeForKids עודכנה כדי להבהיר שהמאפיין הוא לקריאה בלבד. השינוי הזה לא משקף שינוי בפונקציונליות של ה-API.

    כדי לסווג שידור חי כתוכן לילדים, צריך להגדיר את המאפיין status.selfDeclaredMadeForKids לערך true כשקוראים לשיטה liveBroadcasts.insert כדי ליצור את השידור.

  • הערה: השינוי הזה כולל הודעה על הוצאה משימוש ועדכון של הודעה קודמת על הוצאה משימוש.

    השיטה liveBroadcasts.control תצא משימוש ב-1 באוקטובר 2020 או אחריו. אחרי התאריך הזה, כל הקריאות ל-method הזה יחזירו שגיאת איסור (403), וה-method יוסר לגמרי בהמשך. הלקוחות עדיין יכולים להטמיע את שיטת הסלייט שלהם על ידי הוספת שכבת-על לסרטון שנשלח לשרתי ההעלאה של YouTube.

    תאריך ההוצאה משימוש של ההודעה על הוצאה משימוש שפורסמה ב-16 באפריל 2020, שנקבע במקור ל-1 בספטמבר 2020, נדחה ועכשיו הוא יתבצע ב-1 באוקטובר 2020 או אחריו. לכן, התכונות שכלולות בהודעה על הוצאה משימוש ושיטת liveBroadcasts.control יצאו משימוש באותו הזמן.

‫17 ביולי 2020

הערה: זהו עדכון להודעה קודמת על הוצאה משימוש.

השדה cdn.format במשאב liveStream, שיצא משימוש באפריל 2016, לא ייתמך יותר החל מ-17 באוגוסט 2020. הבקשות שעדיין ישתמשו בשדה הזה ייכשלו החל מהתאריך הזה.

אם הקוד שלכם עדיין משתמש בשדה cdn.format, אתם צריכים לעדכן אותו כדי לציין את קצב הפריימים ואת הרזולוציה בנפרד, באמצעות המאפיינים cdn.frameRate ו-cdn.resolution.

‫6 ביולי 2020

המדריך העברת תוכן בשידור חי ב-YouTube באמצעות פרוטוקול HLS עודכן עם כמה שינויים:

בנוסף, בהשוואה בין פרוטוקולי ההזנה חדשים מפורטים פרוטוקולי ההזנה ש-YouTube תומך בהם, רשימת רכיבי ה-codec שנתמכים בכל פרוטוקול ומידע נוסף לגבי תרחישי שימוש מתאימים לכל פרוטוקול.

‫16 באפריל 2020

העדכון הזה כולל נכס חדש והודעה על הוצאה משימוש:

  • במשאב liveBroadcast יש עכשיו תמיכה במאפיין contentDetails.enableAutoStop. המאפיין מציין אם השידור צריך להיפסק אוטומטית כדקה אחרי שבעל הערוץ מפסיק את הסטרימינג של הסרטון בשידור החי המקושר.

    עדכנו את המאמר המחזור חיים של שידור כדי להסביר איך התהליך המפורט של יצירה וניהול של אירוע בשידור חי ב-YouTube משתנה אם מגדירים את המאפיינים contentDetails.enableAutoStart או contentDetails.enableAutoStop לערך true.

  • הערה: זוהי הודעה על הוצאה משימוש. השינויים האלה ייכנסו לתוקף ב-1 בספטמבר 2020 או אחרי התאריך הזה. התאריך בפועל שבו השינויים ייכנסו לתוקף נקרא בהמשך תאריך ההוצאה משימוש.

    במאמר הזה מוסבר על שינוי שעלול לגרום לבעיות. השינוי משפיע על אפליקציות לקוח של API שמשתמשות במשאבי ברירת המחדל liveStream ו-liveBroadcast של ערוצים כדי להזרים תוכן בשידור חי ב-YouTube. במילים אחרות, מזהה השידור ומזהה הסטרימינג שמשויכים לשידור ולסטרימינג הקבועים לא יפעלו יותר כדי להתחיל שידורים חדשים.

    הבקשה שלך תושפע אם אחד מהתנאים הבאים יתקיים:

    • הפונקציה בודקת את הערך של המאפיין isDefaultBroadcast של המשאב liveBroadcast. הנכס הזה לא יוחזר אחרי תאריך ההוצאה משימוש.
    • הפונקציה בודקת את הערך של המאפיין isDefaultStream של המשאב liveStream. הנכס הזה לא יוחזר אחרי תאריך ההוצאה משימוש.
    • היא קוראת לשיטה liveBroadcasts.list ומגדירה את ערך הפרמטר broadcastType ל-persistent או ל-all. הפרמטר הזה יוצא משימוש כחלק מהשינויים האלה. נכון לתאריך הפסקת התמיכה:
      • אם ערך הפרמטר broadcastType הוא persistent, השיטה liveBroadcasts.list לא תחזיר תוצאות.
      • אם ערך הפרמטר broadcastType הוא all, השיטה liveBroadcasts.list לא תחזיר שידורים קבועים שהיו קיימים לפני הזמן הזה.

    כדי לספק קצת רקע, בשנים האחרונות, YouTube יצרה באופן אוטומטי שידור חי שמוגדר כברירת מחדל ושידור שמוגדר כברירת מחדל לערוץ כשהופעלה בו האפשרות של שידור חי בסטרימינג. הסטרימינג שמוגדר כברירת מחדל היה קיים ללא הגבלת זמן, לא שויכו לו שעת התחלה או שעת סיום ולא ניתן היה למחוק אותו. באופן דומה, השידור שמוגדר כברירת מחדל נחשב קבוע. הוא תמיד היה קיים ולא היה קשור לאירוע מסוים.

    החל מתאריך הפסקת התמיכה:

    • מערכת YouTube לא תיצור יותר שידורים ושידורים חיים שמוגדרים כברירת מחדל. במקום להסתמך על משאבי ברירת המחדל, לקוחות API צריכים להיות מסוגלים ליצור ולנהל משאבי liveBroadcast ו-liveStream ולקשר בין המשאבים האלה.
    • אם שידור ברירת המחדל ושידור ברירת המחדל של ערוץ מסוים פעילים, כלומר הערוץ משתמש בהם לשידור חי בזמן שהוצאתם משימוש נכנסת לתוקף, השידור המתמשך לא יושפע. אבל אחרי שהשידור הזה יסתיים, הערוץ לא יוכל להשתמש שוב בשידור ברירת המחדל ובזרם ברירת המחדל.
    • אם השידור שמוגדר כברירת מחדל והסטרימינג שמוגדר כברירת מחדל בערוץ לא פעילים, אחרי שהוצאת התכונה משימוש תיכנס לתוקף, YouTube יתעלם מניסיונות להשתמש במשאבים האלה כדי לשדר סרטון.

    אם השינוי משפיע על האפליקציה שלך, כדאי לעיין במסמכים הבאים שיעזרו לך לעדכן את האפליקציה כך שהיא תמשיך לפעול כצפוי אחרי השינוי:

    • במדריך חדש להעברה מוסבר מהם השלבים שצריך לבצע בממשקי API של לקוחות שמשתמשים כרגע בשידורים ובהזרמות שמוגדרים כברירת מחדל.
    • המדריך המסע של שידור כולל תהליך מפורט שמסביר איך ליצור אירוע בשידור חי ב-YouTube ואיך לנהל אותו. בכל שלב מוסבר על קריאות ה-API או על פעולות אחרות שצריך לבצע כדי להשלים פעולה ספציפית. האפליקציה שלכם תצטרך לפעול בהתאם לתהליך הזה כש-YouTube יפסיק לתמוך בסטרימינג ובשידורים של ברירת המחדל.

31 במרץ 2020

הערה: זוהי הודעה על הוצאה משימוש.

המשאב sponsor והשיטה sponsors.list הוצאו משימוש והוחלפו במשאב member ובשיטה members.list.

התמיכה בשיטה sponsors.list תופסק ב-30 בספטמבר 2020 או אחריו. לקוחות API צריכים לעדכן את הקריאות ל-method‏ sponsors.list כדי להשתמש ב-method‏ members.list במקום זאת. מידע נוסף על המשאב החדש זמין בהיסטוריית הגרסאות של YouTube Data API.

‫11 במרץ 2020

הקטע Ingestion endpoint במדריך Delivering Live YouTube Content via HLS עודכן כדי להבהיר את התהליך שבו מקודד צריך להשתמש כדי להשלים את ערך הפרמטר file= כשיוצרים את כתובות ה-URL הראשיות והגיבוי להעלאת נתונים.

‫4 בפברואר 2020

המדריך העברת תוכן בשידור חי ב-YouTube באמצעות HLS עודכן. עכשיו מצוין בו שבקשות DELETE הן אופציונליות ושנקודת הקצה של HLS ב-YouTube מתעלמת מהן. מטעמי ביצועים, מומלץ ללקוחות לא לשלוח בקשות DELETE.

‫10 בינואר 2020

ה-API תומך עכשיו באפשרות לזהות תוכן שמיועד לילדים, שנקרא ב-YouTube "במיוחד לילדים". מידע נוסף על תוכן עם הסיווג 'במיוחד לילדים' זמין במרכז העזרה של YouTube.

  • המשאב liveBroadcast תומך בשני מאפיינים חדשים שמאפשרים ליוצרי תוכן ולצופים לזהות תוכן שסווג כ'במיוחד לילדים':
    • selfDeclaredMadeForKids המאפיין מאפשר ליוצרי תוכן לציין אם שידור חי הוא תוכן שמיועד לילדים. אפשר להגדיר את המאפיין הזה כשיוצרים שידור באמצעות השיטה liveBroadcasts.insert. הערה: המאפיין הזה נכלל רק בתגובות של API שמכילות משאבי liveBroadcast אם בעלי הערוץ אישרו את בקשת ה-API.
    • madeForKids המאפיין מאפשר לכל משתמש API לאחזר את הסטטוס 'במיוחד לילדים' של שידור. לדוגמה, הסטטוס יכול להיקבע על סמך הערך של המאפיין selfDeclaredMadeForKids. מידע נוסף על הגדרת הקהל של הערוץ, הסרטונים או השידורים זמין במרכז העזרה של YouTube.
  • ב-YouTube Data API, המשאב channel תומך גם במאפיינים חדשים: selfDeclaredMadeForKids ו-madeForKids.

עדכנו גם את התנאים וההגבלות של שירותי ה-API של YouTube ואת כללי המדיניות למפתחים. מידע נוסף מופיע בהיסטוריית הגרסאות של התנאים וההגבלות של שירותי ה-API של YouTube. השינויים בתנאים ובהגבלות של שירותי YouTube API ובמדיניות למפתחים ייכנסו לתוקף ב-10 בינואר 2020, שעון החוף הפסיפי.

‫20 באוגוסט 2019

סעיף הדרישות במדריך העברת תוכן YouTube בשידור חי באמצעות HLS עודכן בשני שינויים:

  • הוא מסביר שמומלץ לכלול בכל רשימת השמעה של מדיה גם פלחים מוכרים וגם פלחים לא מוכרים. השיטה הזו מקטינה את הסיכוי שקטע ידלג אם פלייליסט של מדיה אבד בצד השרת. לדוגמה, ניתן לכלול עד שני קטעים מוכרים ועד חמישה קטעים יוצאי דופן בכל רשימת השמעה של מדיה.
  • כעת נדרש לשלוח רשימת השמעה של מדיה עבור כל מקטע מדיה. זה מאפשר לשרת להתאושש במהירות אם רשימת השמעה של מדיה אובדת. בעבר, השיטה הזו הופיעה כהמלצה.

28 ביוני, 2019

מערכת YouTube תומכת עכשיו בהעלאה בפורמט HLS. בהתאם לכך, המאפיין ingestionType של המשאב liveStream תומך בערך החדש hls כדי לזהות סטרימינג שנקלט ב-YouTube באמצעות HLS.

המדריך החדש להעברת תוכן YouTube בשידור חי דרך HLS מספק הנחיות לשימוש ב-HLS להזרמת תוכן חי ל-YouTube ממקודד. המדריך נועד לסייע לספקי מקודדים להוסיף תמיכה באספקת HLS למוצרים שלהם.

4 באפריל 2019

העדכון הזה כולל את השינויים הבאים:

  • עדכנו את מאמרי העזרה של ה-API כדי להסביר טוב יותר תרחישי שימוש נפוצים לכל שיטה, וכדי לספק דוגמאות קוד דינמיות ואיכותיות באמצעות הווידג'ט APIs Explorer. דוגמה מופיעה במסמכי העזרה של השיטה liveBroadcasts.list. נוספו שני רכיבים חדשים לדפים שמתארים שיטות API:

    • בעזרת הווידג'ט של APIs Explorer אפשר לבחור היקפי הרשאה, להזין ערכים לדוגמה של פרמטרים ומאפיינים, ואז לשלוח בקשות API בפועל ולראות תגובות API בפועל. הווידג'ט מציע גם תצוגת מסך מלא המציגה דוגמאות קוד מלאות, אשר מתעדכנות באופן דינמי כדי להשתמש בהיקפים ובערכים שהזנת.

    • בקטע תרחישים נפוצים לדוגמה מתואר תרחיש נפוץ אחד או יותר לשימוש בשיטה שמוסברת בדף. לדוגמה, אפשר לקרוא לשיטה liveBroadcasts.list כדי לאחזר נתונים על שידור ספציפי או על השידורים של המשתמש הנוכחי.

      אפשר להשתמש בקישורים שבקטע הזה כדי לאכלס את API Explorer בערכים לדוגמה לתרחיש השימוש שלכם, או כדי לפתוח את API Explorer במסך מלא כשהערכים האלה כבר מאוכלסים. המטרה של השינויים האלה היא להקל עליכם לראות דוגמאות קוד שרלוונטיות ישירות לתרחיש השימוש שאתם מנסים להטמיע באפליקציה שלכם.

    דוגמאות קוד נתמכות כרגע בשפות Java,‏ JavaScript,‏ PHP,‏ Python ו-curl.

  • לדף דוגמאות הקוד יש גם ממשק משתמש חדש המציע את כל אותן תכונות שתוארו לעיל. באמצעות הכלי הזה, אפשר לבדוק תרחישי שימוש לשיטות שונות, לטעון ערכים ל-APIs Explorer ולפתוח את APIs Explorer במסך מלא כדי לקבל דוגמאות קוד ב-Java,‏ JavaScript,‏ PHP ו-Python.

    בקשר לשינוי זה, הוסרו הדפים שבעבר רשמו דוגמאות קוד זמינות עבור Java, PHP ו-Python.

25 בפברואר 2019

התיעוד של המשאבים liveChatMessage ו-superChatEvent עודכן כדי לשקף את העובדה ששני המשאבים יכולים כעת להכיל מידע על Super Stickers. סופר סטיקרים הם סוג של הודעת סופר צ'אט שמציגה תמונה. כמו סופר צ'אטים אחרים, הודעת סופר סטיקר נרכשת על ידי מעריץ במהלך שידור חי ביוטיוב.

  • במשאב liveChatMessage, המאפיין snippet.type מוגדר כעת ל-superStickerEvent כדי לציין שהמשאב מכיל מידע על Super Sticker. במקרה כזה, מקור המידע מכיל גם את האובייקט snippet.superStickerDetails, שמכיל מידע נוסף על הסופר סטיקר.
  • במשאב superChatEvent, הערך הבוליאני snippet.isSuperStickerEvent מציין האם הודעת הסופר צ'אט היא גם סופר סטיקר. אם כן, האובייקט snippet.superStickerMetadata מכיל פרטים נוספים על הסופר סטיקר.

5 באפריל, 2018

תיאור השיטה superChatEvents.list עודכן כדי לשקף את העובדה שתגובת ה-API אינה מכילה עוד את fanFundingEvents, אשר הוצאו משימוש בתחילת 2017.

3 באפריל 2017

נוספו דוגמאות קוד ג'אווה חדשות המראות כיצד לרשום, להוסיף ולמחוק הודעות צ'אט חי. בדוגמאות מופעלות המתודות הבאות:

13 בפברואר, 2017

העדכון הזה כולל את השינויים הבאים:

  • עדכונים למשאבים ולשיטות קיימים

    • שיטת liveCuepoints.insert עודכנה כדי לשקף את העובדה שהפרמטר onBehalfOfContentOwner נדרש כעת. בנוסף, תיאור השיטה עודכן כך שיצוין כי קריאות לשיטה זו חייבות להיות מאושרות על ידי חשבון המשויך לבעל תוכן ביוטיוב.

9 בפברואר, 2017

העדכון הזה כולל את השינויים הבאים:

  • עדכונים למשאבים ולשיטות קיימים

    • הפרמטר החדש hl של המתודה superChatEvents.list מאפשר לך לציין שערך המאפיין snippet.displayString צריך להיות מעוצב בהתאם למוסכמות של שפה מסוימת. גם הגדרת הנכס עודכנה בהתאם.

      ערך הפרמטר חייב להיות קוד שפה הכלול ברשימה המוחזרת על ידי השיטה i18nLanguages.list. ערך ברירת המחדל הוא en, מה שאומר שהתנהגות ברירת המחדל היא לעצב מחרוזות תצוגה כפי שהיו משמשות באנגלית. לדוגמה, כברירת מחדל, מחרוזת מעוצבת כ-$1.00 ולא כ-$1,00.

‫1 בפברואר 2017

העדכון הזה כולל את השינויים הבאים:

  • משאבים ושיטות חדשים

    • המשאב החדש של superChatEvent מייצג הודעת סופר צ'אט שנרכשה על ידי מעריץ במהלך שידור חי ביוטיוב. בצ'אט בשידור חי ב-YouTube, הודעות סופר צ'אט מובלטות בשתי דרכים:

      • סופר צ'אטים מסומנים בצבע.
      • הודעות סופר צ'אט נשארות מוצמדות לטקסט למשך פרק זמן מוגדר.

      צבע הסופר צ'אט, משך הזמן שהוא נשאר מוצמד להודעה ואורך ההודעה המרבי נקבעים כולם לפי סכום הרכישה. במרכז העזרה של YouTube תמצאו מידע נוסף על סופר צ'אטים.

      ה-API תומך בשיטה לרישום של אירועי סופר צ'אט עבור שידורים חיים של ערוץ ב-30 הימים האחרונים. השיטה הזו מחזירה גם נתונים על אירועי מימון מעריצים (fanFundingEvents) מהשידור החי האחרון בערוץ.

  • עדכונים למשאבים ולשיטות קיימים

    • המאפיין snippet.type תומך כעת בערך superChatEvent, המציין שהמשאב מתאר סופר צ'אט.

      בנוסף, המאפיין החדש snippet.superChatDetails של משאב liveChatMessage ורכיבי הצאצא שלו מכילים מידע על אירוע Super Chat.

    • המאפיין cdn.resolution של רכיב liveStream תומך עכשיו בערך 2160p.

  • שגיאות חדשות ומעודכנות

    • ה-API תומך בשגיאות החדשות הבאות:

      פרטי השגיאה
      liveBroadcasts.insert, liveBroadcasts.update המתודות liveBroadcasts.insert ו-liveBroadcasts.update מחזירות שגיאות 400 (Bad Request) כדי לציין שמשאב liveBroadcast שמתווסף או מתעדכן מכיל ערך לא חוקי עבור המאפיין contentDetails.enableEmbed או עבור המאפיין contentDetails.projection. סיבות השגיאה לשתי השגיאות החדשות הן invalidEmbedSetting ו-invalidProjection, בהתאמה.

12 בינואר, 2017

הערה: זוהי הודעה על הוצאה משימוש.

במקביל להשקת התכונה החדשה סופר צ'אט, YouTube הוציאה משימוש את פיצ'רים למימון על ידי מעריצים, וממשק ה-API למימון המעריצים יושבת ב-28 בפברואר 2017. נכון לתאריך הזה:

‫11 באוגוסט 2016

העדכון הזה כולל את השינויים הבאים:

  • התנאים וההגבלות החדשים של שירותי YouTube API (להלן 'התנאים המעודכנים'), שמפורטים בבלוג של צוות ההנדסה והמפתחים של YouTube, כוללים מגוון רחב של עדכונים לתנאים ולהגבלות הנוכחיים. בנוסף לתנאים המעודכנים, שייכנסו לתוקף ב-10 בפברואר 2017, העדכון הזה כולל כמה מסמכים תומכים שמסבירים את המדיניות שמפתחים צריכים לפעול לפיה.

    היסטוריית הגרסאות של התנאים המעודכנים כוללת את כל המסמכים החדשים. בנוסף, היסטוריית הגרסאות תכלול הסברים על שינויים עתידיים בתנאים המעודכנים או במסמכים התומכים. אפשר להירשם לעדכונים בפיד RSS שכולל את השינויים בהיסטוריית הגרסאות באמצעות קישור במסמך.

‫20 במאי 2016

מערכת YouTube תומכת עכשיו בהעלאה בפורמט DASH. לכן, המאפיין ingestionType של רכיב liveStream תומך בערך החדש dash לזיהוי סטרימינג שהועלה ל-YouTube באמצעות DASH.

במדריך החדש העברת תוכן לשידור חי ב-YouTube באמצעות DASH מוסבר איך להשתמש בפורמט ההעברה DASH כדי להזרים נתונים בשידור חי ב-YouTube ממקודד. המטרה היא לעזור לספקי מקודדים להוסיף תמיכה במשלוח DASH למוצרים שלהם.

‫18 באפריל 2016

העדכון הזה כולל את השינויים הבאים:

  • עדכונים למשאבים ולשיטות קיימים

    • liveStream עדכוני משאבים

      • מעכשיו אפשר לשדר ב-YouTube ברזולוציה של 1440p ב-30 או ב-60 פריימים לשנייה.

        בנוסף, המשאב liveStream מכיל מאפיינים חדשים שמאפשרים לציין את קצב הפריימים והרזולוציה של נתוני הווידאו הנכנסים:

        מאפיינים
        cdn.frameRate קצב הפריימים של נתוני הסרטון הנכנסים. הערכים התקינים הם 30fps ו-60fps.
        cdn.resolution הרזולוציה של נתוני הווידאו הנכנסים. הערכים התקפים של מאפיין: 1440p,‏ 1080p,‏ 720p,‏ 480p,‏ 360p ו-240p.

      • בהתאם להשקת המאפיינים cdn.frameRate ו-cdn.resolution של המשאב liveStream, המאפיין cdn.format של המשאב הזה יצא משימוש. המאפיין cdn.format מציין את הרזולוציה ואת קצב הפריימים בערך אחד.

        מומלץ לעבור לשדות החדשים שנתמכים. בינתיים, cdn.format ממשיך לפעול. בנוסף, בקשות להוספת שידורים חיים מצליחות כרגע אם מציינים ערכים במאפיין cdn.format או במאפיינים cdn.frameRate ו-cdn.resolution. אם תספקו ערכים לכל שלושת המאפיינים, יכול להיות שה-API יחזיר שגיאה אם הערכים לא תואמים.

        שימו לב: למרות שהמאפיין cdn.format יצא משימוש, הוא תומך עכשיו בשני ערכים חדשים, 1440p ו-1440p_hfr, כדי לשקף את התמיכה של ה-API בסטרימינג באיכות 1440p ב-30 או ב-60 פריימים לשנייה.

    • liveBroadcast עדכוני משאבים

      • משאב liveBroadcast מכיל את המאפיינים החדשים הבאים:

        מאפיינים
        contentDetails.boundStreamLastUpdateTimeMs התאריך והשעה שבהם השידור החי שאליו מתייחס מאפיין contentDetails.boundStreamId של השידור עודכן לאחרונה.
        contentDetails.projection פורמט ההקרנה של השידור. ערך ברירת המחדל של המאפיין הוא rectangular. הערכים החוקיים של המאפיין הם 360 ו-rectangular.

      • העדפנו את ההגדרה של המאפיין statistics.totalChatCount של משאב liveBroadcast כדי לציין שערך המאפיין מוצג רק אם לשידור יש לפחות הודעת צ'אט אחת.

    • liveChatMessage עדכוני משאבים

      • המאפיין snippet.type תומך בשני ערכים חדשים – messageDeletedEvent ו-userBannedEvent – שמתאימים למאפיינים החדשים שמתוארים בתבליט הבא. גם ההגדרה של הנכס snippet.authorChannelId עודכנה כדי להסביר מה ערך הנכס מזהה עבור סוגי ההודעות החדשים האלה.

      • משאב liveChatMessage מכיל את המאפיינים החדשים הבאים:

        מאפיינים
        snippet.messageDeletedDetails האובייקט הזה מכיל מידע על הודעה שנמחקה על ידי מנהל צ'אט. האובייקט מוצג רק אם ערך המאפיין snippet.type הוא messageDeletedEvent.
        snippet.userBannedDetails האובייקט הזה מכיל מידע על משתמש שנחסם מהשתתפות בצ'אט. האובייקט מכיל גם מידע על האיסור עצמו, כלומר אם האיסור הוא קבוע או זמני. אם החסימה זמנית, אחד מהמאפיינים של האובייקט מציין את משך החסימה.

        האובייקט הזה מופיע רק אם ערך המאפיין snippet.type הוא userBannedEvent.

  • שגיאות חדשות ומעודכנות

    • ה-API תומך בשגיאות החדשות הבאות:

      פרטי השגיאה
      liveBroadcasts.bind השיטה liveBroadcasts.bind מחזירה שגיאה 403 (Forbidden) כדי לציין שהמשתמש שלח יותר מדי בקשות בפרק זמן נתון. הסיבה לשגיאה היא userRequestsExceedRateLimit.

      השיטות liveBroadcasts.insert ו-liveBroadcasts.update כבר תומכות באותה שגיאה.
      liveStreams.insert השיטה liveStreams.insert תומכת בארבע שגיאות חדשות מסוג 400 (Bad Request) שמזהות ערך נכס לא חוקי במשאב liveStream שהבקשה ניסתה להוסיף. ברשימה הבאה מפורטות הסיבות לשגיאות והמאפיינים שהן משויכות אליהם:
      liveStreams.insert השיטה liveStreams.insert תומכת בשני סוגים חדשים של שגיאות 400 (Bad Request), שכל אחת מהן מציינת שערך נדרש לא מופיע במשאב liveStream שהבקשה ניסתה להוסיף. ברשימה הבאה מפורטות הסיבות לשגיאות והמאפיינים שהן משויכות אליהם:
      באופן ספציפי, כשמוסיפים משאב liveStream, צריך לציין ערך למאפיין cdn.format או למאפיינים cdn.frameRate ו cdn.resolution.
      • אם לא מציינים ערך לאף אחד משלושת המאפיינים, ה-API מחזיר שגיאה מסוג formatRequired.
      • ה-API מחזיר שגיאה frameRateRequired אם מציינים ערך ל-cdn.resolution אבל לא ל-cdn.frameRate.
      • ה-API מחזיר שגיאה resolutionRequired אם מציינים ערך ל-cdn.frameRate אבל לא ל-cdn.resolution.
      liveStreams.update השיטה liveStreams.update מחזירה שגיאה 403 (Forbidden) אם הבקשה מנסה לשנות את הערך של אחת מהמאפיינים הבאים שאי אפשר לשנות: הערך של reason בתגובה לשגיאה הוא liveStreamModificationNotAllowed.

‫18 בדצמבר 2015

חוקי האיחוד האירופי (EU) מחייבים להציג גילוי נאות מסוים למשתמשי קצה באיחוד האירופי ולקבל מהם הסכמה. לכן, אם אתם מציגים מודעות למשתמשי קצה באיחוד האירופי, אתם צריכים לפעול בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי. הוספנו הודעה על הדרישה הזו בתנאים ובהגבלות של ממשק ה-API של YouTube.

‫17 בדצמבר 2015

העדכון הזה כולל את השינויים הבאים:

  • משאבים ושיטות חדשים

    • ה-API תומך בכמה משאבים חדשים כדי לתמוך בפונקציונליות של צ'אט בשידורים חיים. פלטפורמת YouTube תומכת בפונקציונליות של צ'אט בזמן שידורים חיים פעילים, והמשאבים האלה והשיטות שלהם תומכים באחזור של הודעות בצ'אט וגם בפונקציות ניהול של הצ'אט.

      משאבים
      liveChatMessage המשאב הזה מייצג הודעה בצ'אט בשידור חי ב-YouTube. ב-YouTube יש כמה סוגים של הודעות, כולל הודעות טקסט ואירועים של מימון מעריצים. חלק מסוגי ההודעות מציינים שלב מסוים בצ'אט, כמו תחילת התקופה שבה רק חברים יכולים לכתוב או סיום הצ'אט. ה-API תומך בשיטות לרישום, להוספה ולמחיקה של הודעות בצ'אט בשידור חי.
      liveChatModerators המשאב הזה מזהה מנהל צ'אט. למנהלים יש אפשרות לבצע פעולות ניהוליות מסוימות, כמו חסימת משתמשים בצ'אט או מחיקת הודעות. ממשק ה-API תומך בשיטות לרישום, להוספה ולמחיקה של מנהלים בצ'אט בשידור חי.
      liveChatBans המשאב הזה מזהה משתמש שנאסר עליו לפרסם הודעות בצ'אט מסוים בשידור חי. האיסורים יכולים להיות זמניים או קבועים. ה-API תומך בשיטות להוספה ולמחיקה של חסימות בצ'אט בשידור חי.
      fanFundingEvents המשאב הזה מייצג אירוע של מימון מעריצים בערוץ YouTube. מימון על ידי מעריצים מאפשר לצופים לתמוך ביוצרים ב-YouTube באמצעות תרומה כספית חד-פעמית.

      השיטה fanFundingEvents.list של ה-API מציגה רשימה של אירועי מימון מעריצים בערוץ. אירועים לגיוס תרומות ממעריצים שמתחילים דרך הצ'אט בשידור חי במהלך שידור חי שנמצא בבעלות הערוץ, מפעילים גם הודעה fanFundingEvent בצ'אט בשידור חי של השידור.

      מידע נוסף על מימון ממעריצים זמין במרכז העזרה של YouTube.
      sponsors המשאב sponsor מזהה נותן חסות לערוץ YouTube. הספונסר משלם לערוץ תשלום חודשי. תג מופיע לצד ההודעות של הספונסרים בצ'אטים בשידור חי של הערוץ, והספונסרים יכולים גם להשתתף בצ'אטים בשידור חי שמיועדים רק לספונסרים של הערוץ, אם מתקיימים צ'אטים כאלה.‫

      השיטה sponsors.list ב-API מציגה את רשימת הספונסרים של הערוץ. כשמשתמשים נרשמים לתמיכה בערוץ במהלך שידור חי בבעלות הערוץ, ה-API מוסיף גם הודעה newSponsorEvent לצ'אט בשידור החי של השידור.

      מידע נוסף על חסויות זמין במרכז העזרה של YouTube.

  • עדכונים למשאבים ולשיטות קיימים

    • משאב liveBroadcast מכיל את המאפיינים החדשים הבאים:

      מאפיינים
      snippet.liveChatId המזהה של הצ'אט בשידור חי ב-YouTube של השידור. בעזרת המזהה הזה, אפשר להשתמש בשיטות של משאב liveChatMessage כדי לאחזר, להוסיף או למחוק הודעות בצ'אט. אפשר גם להוסיף או להסיר מנהלי תגובות בצ'אט, לחסום משתמשים מהשתתפות בצ'אטים בשידור חי או להסיר חסימות קיימות.
      contentDetails.closedCaptionsType הערה: הנכס הזה מחליף את הנכס contentDetails.enableClosedCaptions.

      הנכס הזה מציין אם הכתוביות מופעלות בשידור, ואם כן, איזה סוג של כתוביות אתם מספקים:
      • ‫closedCaptionsDisabled: הכתוביות מושבתות בשידור החי.
      • ‫closedCaptionsHttpPost: אתם שולחים כתוביות באמצעות HTTP POST לכתובת URL להעלאה שמשויכת לשידור החי שלכם.
      • ‫closedCaptionsEmbedded: הכתוביות יקודדו בזרם הווידאו בפורמטים EIA-608 ו/או CEA-708.
      contentDetails.enableClosedCaptions המאפיין הזה הוצא משימוש ב-17 בדצמבר 2015. במקומו צריך להשתמש במאפיין contentDetails.closedCaptionsType. ללקוחות API שכבר משתמשים בנכס הזה:
      • הגדרת ערך המאפיין כ-true שווה להגדרת המאפיין contentDetails.closedCaptionsType כ-closedCaptionsHttpPost.
      • הגדרת ערך המאפיין כ-false שווה להגדרת המאפיין contentDetails.closedCaptionsType כ-closedCaptionsDisabled.

    • הפרמטר החדש broadcastType של השיטה liveBroadcasts.list מאפשר לסנן תגובת API כך שתכלול שידורים של אירועים, שידורים קבועים או את כל השידורים.

      שידור מתמשך הוא שידור שתמיד קיים ולא משויך לאירוע מסוים. במילים אחרות, השידור שמוגדר כברירת מחדל בערוץ הוא שידור קבוע, ואפשר לגשת אליו דרך מרכז הבקרה של השידור החי בסטודיו ליוצרים של YouTube. שידורים אחרים בערוץ הם שידורים של אירועים.

  • בשדה status.healthStatus.configurationIssues[].type של המשאב liveStream מדווח על שגיאות חדשות בסטטוס התקינות:

    שגיאות
    audioTooManyChannels האודיו כולל יותר משני ערוצים, אך רק לערוץ אחד (מונו) או לשני ערוצים (סטריאו) יש תמיכה. עליך לתקן את מספר ערוצי האודיו.
    frameRateHigh קצב הפריימים הנוכחי גבוה מדי. צריך להגדיר קצב פריימים של %(framerate)s פריימים לשנייה לכל היותר.

  • תוקן תאריך הפרסום של עדכון התיעוד הקודם.

  • שגיאות חדשות ומעודכנות

    • בנוסף לשגיאות שמוגדרות למשאבים החדשים שצוינו למעלה, ה-API תומך בשגיאות החדשות הבאות:

      פרטי השגיאה
      liveBroadcasts.update
      קוד תגובת HTTPforbidden (403)
      סיבהclosedCaptionsTypeModificationNotAllowed
      תיאוראפשר לשנות את הערך של contentDetails.closedCaptionsType רק כשהשידור במצב created או ready.
      liveBroadcasts.update
      קוד תגובת HTTPinvalidValue (400)
      סיבהinvalidEnableClosedCaptions
      תיאורבמשאב liveBroadcast, הערך של המאפיין contentDetails.enableClosedCaptions לא תואם לערך של ההגדרה contentDetails.closedCaptionType. משנים את המשאב כך שיכלול רק אחד משני המאפיינים, ואז שולחים מחדש את הבקשה.

‫19 באוגוסט 2015

העדכון הזה כולל את השינויים הבאים:

  • משאבים ושיטות חדשים

    • הערה: התיעוד של המשאב liveChat והשיטות שלו הוא סודי וגלוי רק לשותפים נבחרים של YouTube.

      המשאב החדש liveChat מכיל תגובה שפורסמה במהלך שידור חי ב-YouTube. ה-API תומך בשתי שיטות למשאב הזה:

      Methods
      liveChats.list רשימת הודעות בצ'אט בשידור חי לשידור.
      liveChats.insert ליצור הודעת צ'אט חדשה.

      אפשר לאחזר ולפרסם הודעות בצ'אט בזמן אמת רק בזמן שהשידור מתקיים.

  • עדכונים למשאבים ולשיטות קיימים

    • משאב liveStream מכיל את המאפיינים החדשים הבאים:

      מאפיינים
      snippet.isDefaultStream התנאי מציין אם הסטרימינג הזה הוא סטרימינג ברירת המחדל של הערוץ. הזרם שמוגדר כברירת מחדל בערוץ קיים ללא הגבלת זמן, לא משויכות אליו שעת התחלה או שעת סיום, ואי אפשר למחוק אותו. למידע נוסף על אופן הפעולה של סטרימינג כברירת מחדל, אפשר לעיין בהגדרה של המאפיין.
      status.healthStatus האובייקט הזה מכיל מידע שאפשר להשתמש בו כדי לזהות, לאבחן ולפתור בעיות בהזרמת תוכן. האובייקט מכיל מספר מאפייני צאצא שיעזרו לכם להעריך את תקינות השידור החי של הווידאו.

      בפרט, האובייקט status.healthStatus.configurationIssues[] מפרט בעיות שמשפיעות על שידור הווידאו. במסמך חדש, בעיות בהגדרות של משאבי LiveStream, מפורטות כל הבעיות שמדווחות על ידי ה-API.
      contentDetails.isReusable מציין אם אפשר לעשות שימוש חוזר בסטרימינג, כלומר אם אפשר לקשר אותו לכמה שידורים. מקובל שגופי שידור משתמשים שוב באותו סטרימינג לשידורים שונים רבים, אם השידורים האלה מתרחשים בזמנים שונים.

    • משאב liveBroadcast מכיל את המאפיינים החדשים הבאים:

      מאפיינים
      snippet.isDefaultBroadcast מציין אם השידור הזה הוא שידור ברירת המחדל של הערוץ. כשמפעילים בערוץ YouTube את האפשרות לסטרימינג בשידור חי, מערכת YouTube יוצרת בערוץ שידור ושידור ברירת מחדל. השידור מגדיר איך בעל הערוץ שולח סרטון בשידור חי ל-YouTube, והשידור הוא הדרך שבה הצופים יכולים לראות את השידור שמוגדר כברירת מחדל. למידע נוסף על האופן שבו שידורים שמוגדרים כברירת מחדל פועלים, אפשר לעיין בהגדרה של המאפיין.
      contentDetails.enableLowLatency המאפיין מציין אם השידור הזה צריך להיות מקודד לסטרימינג עם השהיה נמוכה. שידור עם השהיה נמוכה יכול לקצר את הזמן שנדרש כדי שהסרטון יוצג למשתמשים שצופים בשידור, אבל הוא גם יכול להשפיע על הרזולוציה של הצופים בשידור.
      statistics.totalChatCount המספר הכולל של הודעות בצ'אט בשידור חי שמשויכות לשידור. המאפיין והערך שלו מוצגים אם השידור גלוי למשתמש והתכונה 'צ'אט בשידור חי' מופעלת. שימו לב: אחרי שהשידור יסתיים, לא יהיה ערך למאפיין הזה. לכן, הנכס הזה לא יזהה את מספר ההודעות בצ'אט בסרטון בארכיון של שידור חי שהסתיים.

  • שגיאות חדשות ומעודכנות

    • בנוסף לשגיאות שמוגדרות למשאב liveChat החדש, ה-API תומך בשגיאה החדשה הבאה:

      פרטי השגיאה
      liveStreams.update
      קוד תגובת HTTPforbidden (403)
      סיבהliveStreamModificationNotAllowed
      תיאורממשק ה-API לא מאפשר לשנות שידור שאפשר להשתמש בו שוב לשידור שאפשר להשתמש בו רק פעם אחת, או להיפך. מידע נוסף זמין במאמר הסבר על שידורים וסטרימינג

‫21 במאי 2015

העדכון הזה כולל את השינויים הבאים:

  • מעכשיו אפשר ב-YouTube להפעיל סטרימינג בשידור חי של סרטונים ב-60 פריימים לשנייה (fps), מה שאומר שההפעלה של משחקים וסרטונים אחרים עם פעולה מהירה תהיה חלקה יותר. כשמפעילים שידור חי ב-YouTube ב-60fps, ‏ YouTube גם מאפשר לצפות בשידור ב-30fps במכשירים שבהם עדיין לא זמינה צפייה בקצב פריימים גבוה.

    המאפיין cdn.format של המשאב liveStream תומך בשני ערכים חדשים לתכונה הזו: 720p_hfr ו-1080p_hfr.

    מידע נוסף על התכונה הזו זמין בבלוג היוצרים של YouTube.

‫21 באוגוסט 2014

העדכון הזה כולל את השינויים הבאים:

  • העדפנו את ההגדרה של הפרמטר walltime של השיטה liveBroadcasts.control כדי לציין שערך המאפיין מוגדר בפורמט ISO 8601 ‏ (YYYY-MM-DDThh:mm:ss.sssZ).

  • ה-API תומך עכשיו בשגיאות הבאות:

    סוג השגיאה פרטי השגיאה תיאור
    insufficientPermissions liveStreamingNotEnabled כל השיטות עבור המשאבים liveBroadcast ו-liveStream מחזירות את השגיאה הזו אם המשתמש שאישר את בקשת ה-API לא קיבל הרשאה להפעיל שידור חי ב-YouTube. פרטים שמסבירים למה המשתמש לא יכול לשדר וידאו בשידור חי עשויים להיות זמינים בהגדרות הערוץ של המשתמש בכתובת https://www.youtube.com/features.
    rateLimitExceeded userRequestsExceedRateLimit השיטות liveBroadcasts.insert ו-liveStreams.insert מחזירות את השגיאה הזו כדי לציין שהמשתמש שלח יותר מדי בקשות בפרק זמן מסוים.

‫2 במאי 2014

העדכון הזה כולל את השינויים הבאים:

  • תיארנו מחדש את liveStream המשאב ואת liveBroadcasts.bind השיטה כדי לציין ששידור יכול להיות משויך רק לשידור וידאו אחד, אבל שידור וידאו יכול להיות משויך לכמה שידורים. השינוי הזה הוא רק תיקון של התיעוד, ולא חל שינוי בפונקציונליות הבסיסית של ה-API.

  • המאפיין contentDetails.monitorStream.enableMonitorStream במשאב liveBroadcast עודכן כדי להסביר שאם הערך של המאפיין הוא true, צריך להעביר את השידור למצב testing לפני שאפשר להעביר אותו למצב live. (אם הערך של המאפיין הוא false, לשידור לא יכול להיות שלב testing, ולכן אפשר להעביר את השידור ישירות למצב live.

  • המאפיין settings.offsetTimeMs של המשאב liveCuepoint עודכן כדי לציין שאסור להזין ערך למאפיין אם לשידור אין זרם נתונים של צג.

  • כל השיטות במשאבים liveBroadcast ו-liveStream תומכות עכשיו בפרמטרים onBehalfOfContentOwner ו-onBehalfOfContentOwnerChannel. הפרמטרים האלה מאפשרים לכם להשתמש באותם פרטי הרשאה כדי להשלים בקשות API לערוצים שונים שמקושרים לאותו בעל תוכן.

  • העדפנו את התיעוד של ה-method liveCuepoints.insert כדי לציין שאפשר להגדיר ערך למאפיין settings.walltime כשמפעילים את ה-method הזה.

  • במסמכי התיעוד בנושא שגיאות מצוין עכשיו קוד תגובת ה-HTTP לכל סוג שגיאה.

  • ה-API תומך עכשיו בשגיאה הבאה:

    סוג השגיאה פרטי השגיאה תיאור
    insufficientPermissions livePermissionBlocked השגיאה הזו מוחזרת בשיטות liveBroadcasts.insert,‏ liveBroadcasts.transition ו-liveStreams.insert אם המשתמש שאישר את הבקשה לא יכול להפעיל וידאו בשידור חי ב-YouTube. פרטים שמסבירים למה המשתמש לא יכול לשדר וידאו בשידור חי עשויים להיות זמינים בהגדרות הערוץ של המשתמש בכתובת https://www.youtube.com/features.

  • השגיאה invalidScheduledStartTime בשיטה liveBroadcasts.insert עודכנה כדי להבהיר ששעת ההתחלה המתוזמנת צריכה להיות קרובה מספיק לתאריך הנוכחי, כך שניתן יהיה לתזמן שידור באופן מהימן בשעה הזו.

‫13 בדצמבר 2013

העדכון הזה כולל את השינויים הבאים:

  • המאפיין status.recordingStatus החדש של המשאב liveBroadcast מזהה את הסטטוס הנוכחי של השידור.

  • המאפיין contentDetails.enableClosedCaptions החדש של רכיב liveBroadcast מציין אם אפשר להטמיע נתונים של כתוביות סמויות לשידור. אפשר להגדיר את ערך המאפיין כשמוסיפים או מעדכנים שידור, אבל אי אפשר לעדכן אותו אחרי שהשידור עובר למצב testing או live. אם מגדירים את המאפיין הזה לערך true, משאב liveStream שמשויך לשידור יציין את כתובת ה-URL להעברה של הכתוביות הסמויות לשידור.

  • המאפיין snippet.scheduledEndTime של המשאב liveBroadcast תומך עכשיו בשידורים שנקבע להם להמשיך ללא הגבלת זמן. בעקבות השינוי הזה, אין יותר צורך לציין את המאפיין הזה בבקשות liveBroadcasts.insert ו-liveBroadcasts.update.

    אם מאחזרים משאב liveBroadcast שלא מצוין בו ערך למאפיין הזה, השידור מתוזמן להמשיך ללא הגבלת זמן. באופן דומה, אם קוראים לשיטה liveBroadcasts.insert או liveBroadcasts.update ולא מציינים ערך למאפיין הזה, השידור יתוזמן להמשך ללא הגבלת זמן.

  • המאפיין contentDetails.recordFromStart של המשאב liveBroadcast, שכבר היה לו ערך ברירת מחדל של true, יכול עכשיו לקבל רק את הערך false אם לערוץ השידור מותר להשבית הקלטות של שידורים חיים.

    אם לערוץ שלכם אין הרשאה להשבית הקלטות, ותנסו להוסיף שידור עם המאפיין recordFromStart שמוגדר לערך false, ה-API יחזיר שגיאה Forbidden. בנוסף, אם לערוץ שלכם אין את ההרשאה הזו ותנסו לעדכן שידור כדי להגדיר את המאפיין recordFromStart לערך false, ה-API יחזיר שגיאה modificationNotAllowed.

  • המשאב liveBroadcast לא מכיל יותר את המאפיין enableArchive, שהוזכר בתיאורים של המאפיינים contentDetails.enableDvr ו-contentDetails.enableEmbed.

  • הרשימה של הערכים התקינים במאפיין status.lifeCycleStatus של משאב liveBroadcast עודכנה וכוללת עכשיו תיאור של כל סטטוס.

  • המאפיין settings.walltime החדש של משאב liveCuepoint מציין את התאריך והשעה שבהם צריך להוסיף את נקודת האות. ה-API מחזיר שגיאה אם בקשה מנסה להוסיף נקודת ציון שמציינת ערך למאפיין הזה ולמאפיין settings.offsetTimeMs.

  • האובייקט החדש contentDetails במשאב liveStream מכיל מידע על הסטרימינג. בשלב הזה, המאפיין היחיד של האובייקט הוא contentDetails.closedCaptionsIngestionUrl, שמציין את כתובת ה-URL להעלאה של הכתוביות שמשויכות לשידור הווידאו.

  • הרשימה של הערכים התקינים במאפיין status.streamStatus של משאב liveStream עודכנה וכוללת עכשיו תיאור של כל סטטוס.

  • הפרמטר החדש walltime של השיטה liveBroadcasts.control מאפשר לציין את התאריך והשעה שבהם יתרחש שינוי בלוח הזמנים. ה-API מחזיר שגיאה אם בבקשה מצוין ערך לפרמטר הזה ולפרמטר offsetTimeMs.

  • בתגובת ה-API לבקשת liveBroadcasts.list, הערך של המאפיין kind השתנה מ-youtube#liveBroadcastList ל-youtube#liveBroadcastListResponse.

  • בתגובת ה-API לבקשת liveStreams.list, הערך של המאפיין kind השתנה מ-youtube#liveStreamList ל-youtube#liveStreamListResponse.

  • המאפיין eventId יצא משימוש גם ב-liveBroadcastListResponse וגם ב-liveStreamListResponse.

  • ה-API תומך בשגיאות החדשות הבאות:

    סוג השגיאה פרטי השגיאה תיאור
    invalidValue conflictingTimeFields השיטה liveBroadcasts.control מחזירה את השגיאה הזו אם בבקשה שלכם צוינו ערכים לפרמטרים offsetTimeMs ו-walltime. בבקשה אפשר להשמיט את שני הפרמטרים או לציין ערך לאחד מהם.
    invalidValue invalidWalltime השיטה liveBroadcasts.control מחזירה את השגיאה הזו אם הערך של הפרמטר walltime לא תקין.
    forbidden enableClosedCaptionsModificationNotAllowed השיטה liveBroadcasts.update מחזירה את השגיאה הזו אם מנסים לעדכן את הערך contentDetails.enableClosedCaptions והסטטוס של השידור הוא לא created או ready.
    invalidValue conflictingTimeFields השיטה liveCuepoints.insert מחזירה את השגיאה הזו אם בבקשה שלכם צוינו ערכים למאפיינים settings.offsetTimeMs ו-settings.walltime. בבקשה אפשר להשמיט את שני המאפיינים או לציין ערך לאחד משני המאפיינים.

    בנוסף, השיטה liveStreams.update כבר לא תומכת בשגיאה cdnRequired בדומה לשיטה liveStreams.insert.

‫10 במאי 2013

העדכון הזה כולל את השינויים הבאים:

‫2 במאי 2013

העדכון הזה כולל את השינויים הבאים:

‫27 במרץ 2013

העדכון הזה כולל את השינויים הבאים:

  • המאפיינים הבאים השתנו במשאב liveBroadcast:

    • השם של הנכס startWithSlateCuepoint השתנה ל-startWithSlate.
    • השם של הנכס enableArchive השתנה ל-recordFromStart.
    • האובייקט slateSettings הוצא משימוש והוסר מהתיעוד. הסרנו גם הודעות שגיאה שקשורות לאובייקט slateSettings או למאפיינים שלו. בנוסף, הסרנו את הקטע 'הצגת לוחות' מהמדריך תחילת העבודה.

  • ה-API לא תומך יותר באפשרות להוסיף לוחות מידע במהלך הצגת סרטון באמצעות השיטה liveCuepoints.insert. המסמכים הבאים עודכנו כדי לשקף שינוי זה:

    • הפונקציונליות הזו לא מוזכרת יותר בדף האינדקס, במדריך תחילת העבודה ובמדריך השידור.

    • המאפיין settings.cueType של המשאב liveCuepoint לא תומך יותר ב-slate כערך מאפיין. (הערך הנתמך היחיד הוא ad.

    • המאפיין settings.eventState של המשאב liveCuepoint הוצא משימוש והוסר מהתיעוד.

‫18 במרץ 2013

העדכון הזה כולל את השינויים הבאים:

  • עדכנו את כל הודעות השגיאה של ה-API כדי להסביר בצורה ברורה יותר את השגיאות האפשריות, וכשזה אפשרי, להציע הנחיות לתיקון שלהן.

  • יכול להיות שממשק ה-API יחזיר עכשיו כמה שגיאות חדשות. ברשימה הבאה מפורטות השגיאות והמתודות של ה-API שעשויות להחזיר את השגיאות האלה:

    • ‫liveBroadcasts.insert – שעת הסיום המתוזמנת של שידור חייבת להיות אחרי שעת ההתחלה המתוזמנת שלו.
    • ‫liveBroadcasts.insert – בשידור צוין סטטוס פרטיות לא תקין.
    • ‫liveBroadcasts.update – המשאב לא מכיל ערך לנכס contentDetails.enableArchive או שלא מוגדר לו ערך.
    • ‫liveBroadcasts.update – המשאב לא מכיל ערך לנכס contentDetails.enableContentEncryption או שלא מוגדר לו ערך.
    • ‫liveBroadcasts.update – המשאב לא מכיל ערך לנכס contentDetails.enableDvr או שלא מוגדר לו ערך.
    • ‫liveStreams.insert – אורך הכותרת של התקציר צריך להיות בין 1 ל-128 תווים.
    • ‫liveStreams.update – המשאב לא מכיל ערך לנכס snippet.title או שלא מוגדר לו ערך.

  • liveStreamהתיעוד של המשאב עודכן כדי לשקף שאין תמיכה בשיטות ההטמעה של שידור מרובה משתתפים ו-WebM, כפי שצוין קודם. רשימת הפורמטים של המאפיין cdn.format עודכנה בהתאם, והאובייקט cdn.multicastIngestionInfo ומאפייני הצאצא שלו הוסרו מהתיעוד של המשאב. בנוסף, הערך http הוסר מרשימת הערכים הנתמכים של cdn.ingestionType.