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

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

‫12 באוקטובר 2026

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

‫18 באוגוסט 2026

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

  • המסמכים של השיטה liveBroadcasts.update עודכנו וכוללים שגיאות חדשות שקשורות למונטיזציה: preconditionFailed (412) (סיבה: videoNotEligibleForAdsMonetization) ו-backendError (503) (סיבה: backendError).

‫17 באוגוסט 2026

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

  • המאפיין החדש snippet.categoryId של המשאב liveBroadcast מאפשר לכם להגדיר, לעדכן ולאחזר את קטגוריית הסרטון שמשויכת לשידור חי.

‫20 ביולי 2026

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

‫9 ביולי 2026

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

‫1 ביוני 2026

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

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

‫26 במרץ 2026

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

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

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

‫12 בינואר 2026

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

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

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

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

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

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

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

‫14 ביולי 2025

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

‫9 באוקטובר 2023

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

‫15 בספטמבר 2023

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

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

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

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

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

    ה-method‏ 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 כשמפעילים את ה-method‏ 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, את ה-codecs שנתמכים בכל פרוטוקול ומידע נוסף על תרחישי שימוש מתאימים לכל פרוטוקול.

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

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

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

31 במרץ 2020

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

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

החל מ-30 בספטמבר 2020, לא תהיה יותר תמיכה בשיטה sponsors.list. לקוחות 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.

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

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

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

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

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

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

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

      בנוסף, המאפיין החדש snippet.superChatDetails של המשאב liveChatMessage והמאפיינים הצאצאים שלו מכילים מידע על אירוע הסופר צ'אט.

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

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

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

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

‫12 בינואר 2017

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫21 במאי 2015

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

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

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

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

‫10 במאי 2013

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

‫2 במאי 2013

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

‫27 במרץ 2013

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

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

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

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

‫18 במרץ 2013

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

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

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