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

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

9 באוקטובר 2023

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

15 בספטמבר 2023

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

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

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

במסמך מפורטים השינויים הבאים ב-API שתומכים בתכונה הזו:

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

1 באוגוסט 2023

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

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

    • snippet.title
    • status.privacyStatus

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

1 בנובמבר 2022

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

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

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

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

  • התיעוד עבור השיטה liveBroadcasts.control הוסר. הודעה על הוצאה משימוש של השיטה הזו פורסמה בספטמבר 2020.

1 באוקטובר 2022

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

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

    • contentDetails.enableContentEncryption
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.startWithSlate

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

  • הוסרו תיעודים של שדות liveBroadcast מיושנים:

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

1 באפריל 2022

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

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

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

  • הנכס החדש ב-snippet.membershipGiftingDetails של המשאב liveChatMessage והצאצאים שלו מכילים מידע על האירוע 'חברות במועדון במתנה'. באופן דומה, הנכס החדש snippet.giftMembershipReceivedDetails והצאצאים שלו מכילים מידע על האירוע 'קבלת חברות במועדון במתנה'.

15 בספטמבר 2021

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

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

    • newSponsorEvent
    • memberMilestoneChatEvent

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

1 בדצמבר 2020

השיטה liveBroadcasts.transition של ה-API תומכת בשגיאה חדשה מסוג 403 (Forbidden), שמציינת שהמשתמש שלח יותר מדי בקשות בפרק זמן נתון. סיבת השגיאה היא userRequestsExceedRateLimit.

21 בספטמבר 2020

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

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

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

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

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

17 ביולי 2020

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

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

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

6 ביולי 2020

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

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

16 באפריל 2020

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

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

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

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

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

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

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

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

    נכון לתאריך ההוצאה משימוש:

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

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

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

31 במרץ 2020

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

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

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

11 במרץ 2020

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

4 בפברואר 2020

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

20 באוגוסט 2019

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

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

28 ביוני 2019

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

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

4 באפריל 2019

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

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

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

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

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

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

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

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

25 בפברואר 2019

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

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

5 באפריל 2018

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

3 באפריל 2017

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

13 בפברואר 2017

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

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

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

9 בפברואר 2017

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

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

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

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

1 בפברואר 2017

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

  • שיטות ומקורות מידע חדשים

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

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

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

      ה-API תומך בשיטה לפירוט אירועי Super Chat לשידורים חיים של ערוץ ב-30 הימים האחרונים. השיטה הזו מחזירה גם נתונים על אירועי 'מימון על ידי מעריצים' (fanFundingEvents) מהשידור החי האחרון של הערוץ.

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

    • הנכס snippet.type תומך עכשיו בערך superChatEvent, שמציין שהמשאב מתאר 'סופר צ'אט'.

      כמו כן, הנכס החדש snippet.superChatDetails של המשאב liveChatMessage והצאצאים שלו מכילים מידע על האירוע Super Chat.

    • המאפיין cdn.resolution של המשאב liveStream תומך עכשיו בערך 2160p.

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

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

      פרטי השגיאה
      liveBroadcasts.insert, liveBroadcasts.update השיטות liveBroadcasts.insert ו-liveBroadcasts.update מחזירות שגיאות 400 (Bad Request) כדי לציין שהמשאב liveBroadcast שנוסף או מתעדכן מכיל ערך לא חוקי למאפיין contentDetails.enableEmbed או למאפיין contentDetails.projection. סיבות השגיאה לשתי השגיאות החדשות הן invalidEmbedSetting ו-invalidProjection, בהתאמה.

12 בינואר 2017

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

לצד השקת התכונה החדשה Super Chat, YouTube הוצא משימוש את התכונה 'מימון על ידי מעריצים', וממשק ה-API של 'מימון על ידי מעריצים' יושבת ב-28 בפברואר 2017. נכון לתאריך:

11 באוגוסט 2016

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

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

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

20 במאי 2016

YouTube תומך עכשיו בהטמעת נתונים של DASH. בהתאם לכך, המאפיין ingestionType של המשאב liveStream תומך בערך החדש dash לזיהוי שידורים שהוטמעו ב-YouTube באמצעות DASH.

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

18 באפריל 2016

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

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

    • liveStream עדכוני משאבים

      • הפלטפורמה של YouTube תומכת עכשיו בשידורים ברזולוציה של 1440p בקצב של 30 FPS או 60 FPS.

        בנוסף, המשאב 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 או 60FPS.

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

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

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

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

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

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

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

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

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

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

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

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

      באובייקט status.healthStatus.configurationIssues[] מפורטות בעיות שמשפיעות על שידור וידאו. מסמך חדש, בעיות הגדרה של משאבים לשידור חי, מפרט את כל הבעיות שמדווחות על ידי ה-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 Creators.

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 שלא מציין ערך עבור הנכס הזה, השידור מתוזמן להימשך ללא הגבלת זמן. באופן דומה, אם תתבצע קריאה ל-method 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 מציין את התאריך והשעה שבהם יש להוסיף את נקודת ה-cuepoint. ה-API מחזיר שגיאה אם בקשה מנסה להוסיף נקודת סימון (Cuepoint) שמציינת ערך לנכס הזה ולמאפיין 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.