הפניית API

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

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 מובלטות בשתי דרכים:

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

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

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

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

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

FanFundingEvents

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

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

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

LiveCuepoints

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

הערה: הפקודה ב-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.