เพิ่มข้อความในแชทสด
Use Case ทั่วไป
ส่งคำขอ
คำขอ HTTP
POST https://www.googleapis.com/youtube/v3/liveChat/messages
การให้สิทธิ์
คำขอนี้ต้องได้รับการให้สิทธิ์อย่างน้อย 1 ขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)
ขอบเขต |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
พารามิเตอร์
ตารางต่อไปนี้แสดงพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงอยู่เป็นพารามิเตอร์การค้นหา
พารามิเตอร์ | ||
---|---|---|
พารามิเตอร์ที่จำเป็น | ||
part |
string พารามิเตอร์ part ทำหน้าที่ 2 ประการ โดยระบุพร็อพเพอร์ตี้ที่การดำเนินการเขียนจะตั้งค่า รวมถึงพร็อพเพอร์ตี้ที่การตอบกลับจาก API จะรวมไว้ ตั้งค่าพารามิเตอร์เป็น snippet |
เนื้อหาของคำขอ
ระบุทรัพยากร LiveChatMessage ในเนื้อหาคำขอ สำหรับทรัพยากรดังกล่าว คุณต้องระบุค่าสำหรับพร็อพเพอร์ตี้เหล่านี้
snippet.liveChatId
snippet.type
- ใช้textMessageEvent
snippet.textMessageDetails.messageText
คำตอบ
หากสำเร็จ เมธอดนี้จะแสดงทรัพยากร 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