דף זה תורגם על ידי Cloud Translation API.

LiveChatMessages: insert

הוספת הודעה לצ'אט בשידור חי.

תרחישים נפוצים לדוגמה

POST https://www.googleapis.com/youtube/v3/liveChat/messages

בקשה זו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).

היקף
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים המפורטים הם פרמטרים של שאילתות.

פרמטרים
הפרמטרים הנדרשים
`part`	`string` הפרמטר `part` משמש לשתי מטרות. היא מזהה את המאפיינים שפעולת הכתיבה תגדיר, וכן את המאפיינים שייכללו בתגובת ה-API. מגדירים את ערך הפרמטר כ-`snippet`.

צריך לספק משאב LiveChatMessage בגוף הבקשה. עבור המשאב הזה, צריך לציין ערכים למאפיינים האלה

אם הפעולה בוצעה בהצלחה, השיטה מחזירה משאב של LiveChatMessage בגוף התשובה.

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

סוג השגיאה	פרטי השגיאה	תיאור
`forbidden (403)`	`forbidden`	אין לך את ההרשאות הנדרשות כדי ליצור את ההודעה שצוינה.
`forbidden (403)`	`liveChatDisabled`	הצ'אט בשידור חי שצוין הושבת על ידי הבעלים, ולכן לא ניתן להוסיף הודעות לצ'אט.
`forbidden (403)`	`liveChatEnded`	הצ'אט בשידור חי שצוין כבר לא פעיל.
`invalidValue (400)`	`messageTextInvalid`	טקסט ההודעה (`snippet.textMessageDetails.messageText`) אינו חוקי.
`notFound (404)`	`liveChatNotFound`	הצ'אט בשידור חי שצוין בבקשת ה-API לא קיים. הודעת השגיאה הזו מופיעה אם הבעלים מחק את הצ'אט.
`required (400)`	`liveChatIdRequired`	המשאב liveChatMessage חייב לכלול ולציין ערך עבור המאפיין `snippet.liveChatId`.
`required (400)`	`messageTextRequired`	המשאב liveChatMessage חייב לכלול ולציין ערך עבור המאפיין `snippet.textMessageDetails.messageText`.
`required (400)`	`typeRequired`	המשאב liveChatMessage חייב לכלול ולציין ערך עבור המאפיין `snippet.type`. יש להגדיר את ערך הפרמטר ל-`text`
`required (400)`	`preconditionCheckFailed`	כבר קיים סקר פעיל מוצמד.
`rateLimitExceeded`	`rateLimitExceeded`	המשתמש פרסם יותר מדי הודעות צ'אט בפרק זמן נתון.

משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה והתגובה של ה-API.