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

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

9 באוקטובר 2023

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

15 בספטמבר 2023

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

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

  • אורך המרווח בין ההפסקות למודעות באמצע הסרטון.
  • את אסטרטגיית התזמון של נקודות ציון במודעה. אפשר להוסיף נקודות סימון בו-זמנית לכל הצופים, אחרת התזמון של נקודות הרמז יכול להשתנות בין צופים. האסטרטגיה השנייה מאפשרת ל-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 הוצאה משימוש. התמיכה ב-method 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 והצאצאים שלו מכילים מידע על האירוע ב-Chat של חברי מועדון שהגיעו לציון דרך. באופן דומה, המאפיין החדש 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 מאפשר ליוצרי תוכן לציין אם שידור חי הוא תוכן לילדים. אפשר להגדיר את המאפיין הזה כשיוצרים שידור באמצעות ה-method 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 שמוצגת בה תמונה. בדומה להודעות Super Chat אחרות, הודעת Super Sticker נרכשת על ידי מעריץ במהלך שידור חי ב-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 מייצג הודעת Super Chat שנרכשה על ידי מעריץ במהלך שידור חי ב-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 Delivery לצורך סטרימינג של נתונים בשידור חי ב-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 תומך בשתי שיטות למשאב הזה:

      שיטות
      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 של ה-method 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 החדש של ה-method 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 ה-method 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.