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