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

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

9 באוקטובר 2023

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

15 בספטמבר 2023

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

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

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

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

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

‫1 באוגוסט 2023

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

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

    • snippet.title
    • status.privacyStatus

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

1 בנובמבר 2022

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

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

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

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

  • מסמכי התיעוד של השיטה liveBroadcasts.control הוסרו. הודעה על הוצאה משימוש של השיטה הזו פורסמה בספטמבר 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

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

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

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

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

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

17 ביולי 2020

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

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

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

6 ביולי 2020

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

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

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, ה-method‏ 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) במדריך העברת תוכן בשידור חי ב-YouTube באמצעות HLS עודכן כדי להבהיר את התהליך שבו המקודד צריך להשתמש כדי להשלים את ערך הפרמטר file= כשיוצרים את כתובות ה-URL הראשיות והגיבוי להטמעה.

4 בפברואר 2020

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

10 בינואר 2020

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

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

עדכנו גם את התנאים וההגבלות של שירותי YouTube API ואת כללי המדיניות למפתחים. למידע נוסף, אפשר לעיין בתנאים ובהגבלות של שירותי YouTube API – היסטוריית הגרסאות. השינויים בתנאים ובהגבלות של שירותי 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:

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

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

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

    נכון לעכשיו יש תמיכה בדוגמאות קוד ל-Java,‏ JavaScript,‏ PHP,‏ Python ו-curl.

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

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

25 בפברואר 2019

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

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

5 באפריל 2018

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

3 באפריל 2017

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

13 בפברואר 2017

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

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

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

9 בפברואר 2017

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

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

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

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

‫1 בפברואר 2017

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

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

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

      • הודעות Super Chat מודגשות בצבע.
      • הודעות Super Chat נשארות מוצמדות לשורת ההודעות לפרק זמן קבוע.

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

      ה-API תומך בשיטה לרישום אירועי Super Chat בשידורים החיים של הערוץ ב-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

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

במקביל להשקת התכונה החדשה Super Chat, הוצאנו משימוש את התכונה 'מימון על ידי מעריצים' ב-YouTube, ו-Fan Funding 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 באופן חד-פעמי.

      ה-method‏ 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 Studio. שאר השידורים בערוץ הם שידורי אירועים.

  • השדות 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[] מפורטות בעיות שמשפיעות על שידור הווידאו. במסמך החדש Configuration Issues for LiveStream Resources מפורטות כל הבעיות שמדווחות על ידי ה-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 לערוצים שונים שמשויכים לאותו בעל תוכן.

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

  • מסמכי התיעוד של השגיאות כוללים עכשיו את קוד התגובה של 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 לא תומך יותר באפשרות להוסיף קטעי וידאו של מודעות In-stream באמצעות השיטה 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 עודכנו כך שישקפו את העובדה ש-multicast ו-WebM הן לא שיטות הטמעה נתמכות, כפי שצוין קודם. רשימת הפורמטים של נכס cdn.format עודכנה בהתאם, והאובייקט cdn.multicastIngestionInfo ונכסי הצאצאים שלו הוסרו מהמסמכי העזרה של המשאב. בנוסף, הערך http הוסרה מרשימת הערכים הנתמכים של cdn.ingestionType.