במסמך הזה מוסבר איך לתזמן שידורים חיים ושידורי וידאו ב-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. |