เพิ่มข้อความในแชทสด ปัจจุบัน API รองรับความสามารถในการแทรก SMS เท่านั้น
กรณีการใช้งานทั่วไป
ส่งคำขอ
คำขอ 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 ข้อผิดพลาดนี้เกิดขึ้นหากเจ้าของลบแชทไปแล้ว |
rateLimitExceeded |
rateLimitExceeded |
ผู้ใช้ส่งข้อความแชทมากเกินไปในกรอบเวลาที่กําหนด |
required (400) |
liveChatIdRequired |
ทรัพยากร liveChatMessage ต้องประกอบด้วยและระบุค่าสําหรับพร็อพเพอร์ตี้ snippet.liveChatId |
required (400) |
messageTextRequired |
ทรัพยากร liveChatMessage ต้องประกอบด้วยและระบุค่าสําหรับพร็อพเพอร์ตี้ snippet.textMessageDetails.messageText |
required (400) |
typeRequired |
ทรัพยากร liveChatMessage ต้องประกอบด้วยและระบุค่าสําหรับพร็อพเพอร์ตี้ snippet.type ตั้งค่าค่าพารามิเตอร์เป็น text |
ลองใช้เลย
ใช้ APIs Explorer เพื่อเรียกใช้ API นี้และดูคําขอและการตอบกลับ API