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

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

‫9 ביולי 2025

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

‫1 ביוני 2026

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

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

‫26 במרץ 2026

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

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

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

‫12 בינואר 2026

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

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

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

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

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

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

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

‫14 ביולי 2025

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

‫9 באוקטובר 2023

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

‫15 בספטמבר 2023

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

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

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

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

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

‫1 באוגוסט 2023

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

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

    • snippet.title
    • status.privacyStatus

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

1 בנובמבר 2022

  • השיטה החדשה liveBroadcasts.cuepoint מאפשרת לכל בעל ערוץ שמפעיל שידור חי ב-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 או אחריו. אחרי התאריך הזה, כל הקריאות ל-method הזה יחזירו שגיאת איסור (403), וה-method יוסר לגמרי בהמשך. לקוחות עדיין יכולים להטמיע את שיטת הוספת הלוח שלהם על ידי הוספת שכבת-על לסרטון שנשלח לשרתי ההעלאה של YouTube.

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

‫17 ביולי 2020

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

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

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

‫6 ביולי 2020

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

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

‫16 באפריל 2020

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

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

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

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

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

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

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

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

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

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

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

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

31 במרץ 2020

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

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

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

‫11 במרץ 2020

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

‫4 בפברואר 2020

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

‫10 בינואר 2020

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

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

עדכנו גם את התנאים וההגבלות של שירותי 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:

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

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

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

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

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

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

25 בפברואר 2019

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

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

‫17 בדצמבר 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫19 באוגוסט 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫21 במאי 2015

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

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

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

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

‫21 באוגוסט 2014

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

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

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

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

‫2 במאי 2014

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

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

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

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

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

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

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

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

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

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

‫13 בדצמבר 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫10 במאי 2013

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

‫2 במאי 2013

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

‫27 במרץ 2013

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

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

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

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

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

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

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

‫18 במרץ 2013

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

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

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

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

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