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

‫1 באוגוסט 2023

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

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

    • snippet.title
    • status.privacyStatus

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

1 בנובמבר 2022

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

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

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

    ה-method‏ liveCuepoints.insert הוצאה משימוש. התמיכה ב-method‏ 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 כדי ליצור את השידור.

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

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

‫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.

החל מ-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

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

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

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

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

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

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

‫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 ה-method‏ liveBroadcasts.bind מחזירה שגיאת 403 (Forbidden) כדי לציין שהמשתמש שלח יותר מדי בקשות בפרק זמן נתון. הסיבה לשגיאה היא userRequestsExceedRateLimit.

      השיטות liveBroadcasts.insert ו-liveBroadcasts.update כבר תומכות באותה שגיאה.
      liveStreams.insert ה-method‏ liveStreams.insert תומכת בארבע שגיאות 400 (Bad Request) חדשות שמזהות ערך נכס לא חוקי במשאב liveStream שהבקשה ניסתה להוסיף. ברשימה הבאה מפורטות הסיבות לשגיאות והמאפיינים שמשויכים אליהן:
      liveStreams.insert ה-method‏ 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 ה-method‏ liveStreams.update מחזירה שגיאת 403 (Forbidden) אם הבקשה מנסה לשנות את הערך של אחד מהמאפיינים הבאים שלא ניתנים לשינוי: הערך של reason בתגובת השגיאה הוא liveStreamModificationNotAllowed.

‫18 בדצמבר 2015

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

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