מקורות ל-API

במסמך הזה מוסבר איך לתזמן שידורים חיים ושידורי וידאו ב-YouTube באמצעות YouTube Live Streaming API.

סוגי המשאבים

LiveBroadcasts

משאב liveBroadcast מייצג אירוע שיועבר בסטרימינג בשידור חי ב-YouTube.

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

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
bind POST /liveBroadcasts/bind קושר שידור ב-YouTube לסטרימינג או מסיר קשר קיים בין שידור לסטרימינג. שידור יכול להיות מקושר רק לשידור וידאו אחד, אבל שידור וידאו יכול להיות מקושר לכמה שידורים.
delete DELETE /liveBroadcasts מחיקת שידור.
insert POST /liveBroadcasts יצירת שידור.
list GET /liveBroadcasts הפונקציה מחזירה רשימה של שידורים ב-YouTube שתואמים לפרמטרים של בקשת ה-API.
transition POST /liveBroadcasts/transition משנה את הסטטוס של שידור חי ב-YouTube ומתחיל תהליכים שמשויכים לסטטוס החדש. לדוגמה, כשמעבירים את הסטטוס של שידור ל-testing, מערכת YouTube מתחילה לשדר וידאו לזרם המעקב של השידור הזה. לפני שמפעילים את השיטה הזו, צריך לוודא שהערך של המאפיין status.streamStatus של הסטרים שמשויך לשידור הוא active.
update PUT /liveBroadcasts עדכון של שידור. לדוגמה, אפשר לשנות את הגדרות השידור שמוגדרות באובייקט contentDetails של משאב liveBroadcast.
cuepoint POST /liveBroadcasts/cuepoint הוספת נקודת רמז לשידור חי. יכול להיות שנקודת האות תפעיל הפסקה למודעה.

LiveChatBans

liveChatBan מקור מידע מזהה משתמש ב-YouTube וצ'אט בשידור חי ב-YouTube שהמשתמש נחסם מהשתתפות בו.

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

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/bans הסרת חסימה שמונעת ממשתמש ספציפי להשתתף בצ'אט בשידור חי, וכך מאפשרת למשתמש להצטרף מחדש לצ'אט. בקשת ה-API צריכה להיות מאושרת על ידי בעלי הערוץ או על ידי מנהל תגובות בצ'אט בשידור חי שמשויך לחסימה.
insert POST /liveChat/bans חסימת משתמש מסוים מהשתתפות בצ'אט בשידור חי. בקשת ה-API צריכה להיות מאושרת על ידי בעלי הערוץ או על ידי מנהל תגובות בצ'אט בשידור חי שמשויך לחסימה.

LiveChatMessages

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

התכונה של הצ'אט בשידור חי מופעלת כברירת מחדל בשידורים חיים, והיא זמינה בזמן שהאירוע בשידור חי פעיל. (אחרי שהאירוע מסתיים, הצ'אט בשידור חי לא זמין יותר לאירוע הזה).

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

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/messages מחיקת הודעה בצ'אט. בקשת ה-API צריכה להיות מאושרת על ידי בעלי הערוץ או על ידי מנהל תגובות בצ'אט בשידור חי שמשויך לחסימה.
insert POST /liveChat/messages הוספת הודעה לצ'אט בשידור חי.
list GET /liveChat/messages מציג את ההודעות בצ'אט בשידור חי של צ'אט ספציפי.
streamList הדגמת קוד האפשרות הזו מפעילה חיבור לשידור בשרת כדי לקבל הודעות בצ'אט בשידור חי בצ'אט ספציפי עם זמן אחזור קצר.

LiveChatModerators

משאב liveChatModerator מייצג מנהל תגובות בצ'אט בשידור חי ב-YouTube. למנהל הצ'אט יש אפשרות לחסום משתמשים בצ'אט או לבטל את החסימה שלהם, להסיר הודעות ולבצע פעולות ניהול אחרות בצ'אט בשידור חי.

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

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
delete DELETE /liveChat/moderators הסרה של מנהל תגובות בצ'אט. הבקשה צריכה להיות מאושרת על ידי הבעלים של הערוץ שבו מתבצע השידור החי.
insert POST /liveChat/moderators הוספת מנהל תגובות חדש לצ'אט. הבקשה צריכה להיות מאושרת על ידי הבעלים של הערוץ שבו מתבצע השידור החי.
list GET /liveChat/moderators מציג את רשימת המנהלים של הצ'אט בשידור חי. הבקשה צריכה להיות מאושרת על ידי הבעלים של הערוץ שבו מתבצע השידור החי.

LiveStreams

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

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

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
delete DELETE /liveStreams מחיקת מקור נתונים של וידאו.
insert POST /liveStreams יוצר זרם וידאו. השידור מאפשר לכם לשלוח את הסרטון ל-YouTube, ואז YouTube יכול לשדר את הסרטון לקהל שלכם.
list GET /liveStreams מחזירה רשימה של סטרימינג של סרטונים שתואמים לפרמטרים של בקשת ה-API.
update PUT /liveStreams עדכון של וידאו בסטרימינג. אם אי אפשר לעדכן את המאפיינים שרוצים לשנות, צריך ליצור זרם חדש עם ההגדרות המתאימות.

SuperChatEvents

superChatEvent משאב מייצג הודעת סופר צ'אט שנרכשה על ידי מעריץ במהלך שידור חי ב-YouTube. בצ'אט בשידור חי ב-YouTube, הודעות סופר צ'אט מובלטות בשתי דרכים:

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

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

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

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
list GET /superChatEvents רשימה של אירועי סופר צ'אט משידורים חיים בערוץ ב-30 הימים האחרונים.

סוגי משאבים שהוצאו משימוש

FanFundingEvents

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

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

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
list GET /fanFundingEvents הפונקציה מחזירה רשימה של אירועים שקשורים למימון על ידי מעריצים בערוץ. הבעלים של הערוץ צריכים לאשר את בקשת ה-API.

LiveCuepoints

liveCuepoint משאב liveBroadcast או liveStream מתחיל הפסקה לפרסומות בשידור הווידאו.

הערה: הפקודה ב-API לשליטה בנקודות האיתות היא למעשה חלק מ-YouTube Content ID API, ויש לה דרישות הרשאה שונות מאלה של בקשות לניהול משאבי liveBroadcast ו-liveStream.

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

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/
insert POST /liveCuepoints הוספת נקודת רמז לשידור חי. נכון לעכשיו, בקשות לשיטה הזו צריכות להיות מאושרות על ידי חשבון שמשויך לבעלי תוכן ב-YouTube.

נותני חסות

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

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

שיטה בקשת HTTP תיאור
מזהי URI יחסיים ל-https://www.googleapis.com/youtube/v3
list GET /sponsors רשימת הספונסרים של הערוץ. הבעלים של הערוץ צריכים לאשר את בקשת ה-API.