הפניית API

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

סוגי המשאבים

שידורים חיים

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

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

‏Method בקשת 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 שהמשתמש אסור להשתתף בו.

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

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

הודעות צ'אט בשידור חי

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

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

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

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

מנהלי תגובות בצ'אט בשידור חי

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

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

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

שידורים חיים

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

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

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

נותני חסות

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

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

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

סופר צ'אט

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

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

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

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

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

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

מימון על ידי אוהדים

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

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

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