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

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

‫12 בינואר 2026

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

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

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

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

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

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

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

‫14 ביולי 2025

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

‫9 באוקטובר 2023

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

‫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

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

‫15 בספטמבר 2021

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

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

    • newSponsorEvent
    • memberMilestoneChatEvent

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

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

במדריך העברת תוכן לשידור חי ב-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.

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

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

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

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