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

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

‫14 ביולי 2025

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

‫9 באוקטובר 2023

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

‫15 בספטמבר 2023

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

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

  • אורך המרווח בין ההפסקות למודעות באמצע הסרטון.
  • אסטרטגיית התזמון של נקודות ציון למודעות. אפשר להוסיף את נקודות ה-Cue בו-זמנית לכל הצופים, או לשנות את התזמון שלהן מצופה לצופה. השיטה השנייה מאפשרת ל-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 הוסר. 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 ורכיבי הצאצא שלו מכילים מידע על האירוע Gift Membership Received (קבלת חברות במתנה).

‫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 או אחריו. אחרי התאריך הזה, כל השיחות לשיטה הזו יחזירו שגיאה מסוג forbidden ‏ (403), והשיטה תוסר לחלוטין בשלב מאוחר יותר. הלקוחות עדיין יכולים להטמיע את תהליך יצירת ה-slate שלהם על ידי הוספת שכבת-על לסרטון שנשלח לשרתי ההעלאה של 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. במילים אחרות, מזהה השידור ומזהה הסטרימינג שמשויכים לשידור ולסטרימינג הקבועים לא יפעלו יותר כדי להתחיל שידורים חדשים.

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

    • היא בודקת את הערך של המאפיין liveBroadcast של המשאב isDefaultBroadcast. הנכס הזה לא יוחזר אחרי תאריך ההוצאה משימוש.
    • היא בודקת את הערך של המאפיין liveStream של המשאב isDefaultStream. הנכס הזה לא יוחזר אחרי תאריך ההוצאה משימוש.
    • היא קוראת לשיטה 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

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

    • בעזרת הווידג'ט של API 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. סופר סטיקרים הם סוג של הודעת סופר צ'אט שמוצגת כתמונה. בדומה להודעות סופר צ'אט אחרות, מעריצים יכולים לקנות סופר סטיקרים במהלך שידור חי ב-YouTube.

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

‫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 נשארות מוצמדות לשורת ההודעות לפרק זמן קבוע.

      הצבע של הסופר צ'אט, פרק הזמן שבו הוא נשאר מוצמד לשורת ההודעות ואורך ההודעה המקסימלי נקבעים לפי סכום הרכישה. במרכז העזרה של 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

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

במקביל להשקת התכונה החדשה סופר צ'אט, הוצאנו משימוש את התכונה 'מימון על ידי מעריצים', וה-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

חוקי האיחוד האירופי מחייבים להציג גילוי נאות מסוים למשתמשי קצה באיחוד האירופי ולקבל מהם הסכמה. לכן, אם אתם מציגים מודעות למשתמשי קצה באיחוד האירופי, אתם צריכים לפעול בהתאם למדיניות 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 עבור ערוצים שונים שמשויכים לאותם בעלי תוכן.

  • עדכנו את התיעוד של השיטה 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 לא תומך יותר באפשרות להוסיף לוחות מידע בתוך סרטונים באמצעות השיטה 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.